Pi × Nowledge Mem

Read https://mem.nowledge.co/SKILL.md and follow the instructions to install or update Nowledge Mem for Pi. Verify with nmem status and the Context Bundle or Working Memory check, then summarize what changed.

pi install npm:nowledge-mem-pi

Pi is a minimal, extensible terminal coding agent. Nowledge Mem adds the layer above: knowledge from all your other AI tools, decisions made in Claude Code, preferences set in Cursor, insights from ChatGPT, searchable inside Pi. After you install the package, completed Pi conversations also sync back to Nowledge Mem as threads, so future tools can find what happened in Pi.

The package now has two automatic paths: Pi receives your Context Bundle or Working Memory at session startup, and completed Pi conversations are captured as searchable threads. Skills remain available for live search, saving decisions, and explicit handoffs.

Before You Start

• Nowledge Mem running locally (installation)
• Pi installed
• nmem CLI in your PATH. In Nowledge Mem go to Settings → Preferences → Developer Tools → Install CLI, or pip install nmem-cli

nmem status   # Nowledge Mem is running
pi --version  # Pi is available

Setup

pi install npm:nowledge-mem-pi

Is Nowledge Mem connected? Run the status skill.

Update

pi update

Restart Pi after updating so the Nowledge Mem extension reloads.

Import Older Sessions

Automatic sync starts after the package is installed. If you have older Pi sessions you want in Nowledge Mem, run a one-time history import.

Preview first:

nmem t sync --from pi --limit 20

Then import:

nmem t sync --from pi --apply

The command reads Pi session files on this machine and writes them to the Mem server configured for your CLI or extension. It is safe to run again: Pi session IDs become stable thread IDs, and repeated messages are deduplicated.

Useful filters:

nmem t sync --from pi --session-dir ~/.pi/agent/sessions --limit 20
nmem t sync --from pi --space work --apply

When you pass --session-dir, only that directory is scanned. Without it, the command uses Pi's standard session locations.

If your installed nmem does not have t sync yet, use the package fallback:

npx -p nowledge-mem-pi nowledge-mem-pi-sync --apply

Customize Safely

Use your project's own AGENTS.md, not the installed package cache.

• Merge the package guidance into AGENTS.md when you want Pi to search or save more proactively in this repo
• Keep package files as shipped defaults so updates stay clean

Pi does not expose a separate durable override file beyond its normal project guidance surface. For the full host-by-host map, see Customize Integration Behavior.

What You Can Do

Keep Pi conversations searchable

The package includes a native Pi extension. After installation, completed turns and session boundaries sync the active Pi session branch into a pi thread in Nowledge Mem. /new, resume, compaction, and clean exit all get a final bounded flush.

Find knowledge from other tools

Ask "what did we decide about the database?" and Pi can search across decisions you made in Claude Code, insights from ChatGPT, notes from Cursor, not just this session.

Save knowledge for everywhere

When you reach a conclusion in Pi, distill-memory lets Pi save it so your next Claude Code session, Cursor project, or ChatGPT conversation can find it too.

Start with today's context

The extension injects Context Bundle first, then falls back to Working Memory when needed. Pi starts with owner identity, AI Identity, active scope, Rules, and today's priorities when your Mem server supports them.

Project AGENTS.md is still useful, but for behavior rather than bootstrapping: use it to make Pi search and save more proactively in a specific repo.

Create resumable handoffs

Automatic thread sync keeps the transcript available. When you ask Pi to save a handoff, you also get a concise structured summary you can pick up in Claude Code or any other tool.

Skills

Configuration

No config needed for local use.

For a persistent shared setup, configure this machine once with nmem config client .... The Pi extension uses the same ~/.nowledge-mem/config.json as the CLI. Environment variables still take priority when you need a temporary override.

Remote access

nmem config client set url https://your-server
nmem config client set api-key your-key

See Access Mem Anywhere.

Troubleshooting

nmem not found. Install with pip install nmem-cli, then run nmem status to verify.

Server not responding. Start the Nowledge Mem desktop app, or check nmem status for diagnostics.

Skills not loading. Run pi list to confirm the package is installed. If nowledge-mem-pi does not appear, reinstall with pi install npm:nowledge-mem-pi.

Pi conversations are not appearing in Threads. Restart Pi after installing or updating, then run a short conversation with both a user message and an assistant reply. Check:

nmem t list --source pi -n 5

The extension intentionally skips one-message sessions so /new or empty starts do not create noise.

Older Pi conversations are missing. Automatic sync cannot see conversations that happened before the package was installed. Use nmem t sync --from pi to preview and import historical Pi session files.

Related

• Connectors overview
• Claude Code · OpenCode · Hermes Agent · OpenClaw · Alma · Bub
• Plugin source: nowledge-mem-pi-package