Nowledge Mem for Pi

Cross-tool memory for Pi. Your decisions, preferences, and procedures persist across sessions and across every AI tool you use.

What You Get

Pi gains a native extension plus five skills:

• Completed Pi conversations sync into Nowledge Mem as searchable threads
• Context Bundle or Working Memory is injected at Pi startup when available
• Search, thread lookup, and distillation stay available through skills and the nmem CLI
• Remote Mem works through ~/.nowledge-mem/config.json or NMEM_API_URL / NMEM_API_KEY

| Skill | What it does | |-------|-------------| | read-working-memory | Loads your daily briefing at session start: focus areas, priorities, recent changes | | search-memory | Searches past decisions, procedures, and preferences when context would help | | distill-memory | Saves decisions, insights, and procedures as durable memories | | save-thread | Creates a curated handoff summary when you explicitly want one | | status | Checks Nowledge Mem server connectivity |

Prerequisites

1. Nowledge Mem desktop app running, or a remote server.
2. nmem CLI in your PATH:

pip install nmem-cli    # or: pipx install nmem-cli
# Arch Linux: yay -S nmem-cli  # or: paru -S nmem-cli
nmem status             # verify connection

On Windows/Linux with the Nowledge Mem desktop app, nmem is already bundled.

Install

Via Pi package manager:

pi install npm:nowledge-mem-pi

Manual install:

Copy the skills/ directory and extension into your Pi config:

# Global skills
cp -r skills/* ~/.pi/agent/skills/
mkdir -p ~/.pi/agent/extensions
cp extensions/nowledge-mem.ts ~/.pi/agent/extensions/

# Or project-local skills
cp -r skills/* .pi/skills/
mkdir -p .pi/extensions
cp extensions/nowledge-mem.ts .pi/extensions/

Verify

Start a Pi session and check connectivity:

> check my Nowledge Mem status

Pi should run nmem --json status and report the server connection.

Then have a short Pi exchange and check recent threads:

nmem t list --source pi -n 5

To confirm startup context injection, start a new Pi session and ask what Nowledge Mem context was provided. Pi should reference the injected Context Bundle or Working Memory without needing to run the read-working-memory skill again.

Import Older Pi Sessions

The extension keeps new Pi conversations synced automatically. To backfill sessions that happened before you installed the package, run the history sync command.

Preview first. This scans Pi session files and makes no changes:

nmem t sync --from pi --limit 20

Import after the preview looks right:

nmem t sync --from pi --apply

The command uses the same local or remote Mem configuration as the extension: ~/.nowledge-mem/config.json, NMEM_API_URL, NMEM_API_KEY, and optional NMEM_SPACE. It is safe to rerun: thread IDs come from Pi session IDs, and messages use stable Pi entry IDs with backend deduplication.

Useful options:

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

Update

pi update

Project Guidance

For behavioral guidance that shapes how Pi uses these skills (when to search, when to save, retrieval routing), see AGENTS.md. Place it alongside your project configuration so Pi follows it automatically.

Customize without editing the package

Use your project's own AGENTS.md as the override layer for Pi.

• Keep the package skills as shipped defaults
• Copy or merge the package AGENTS.md into your project config area
• Do not patch installed package files under the Pi package cache

That keeps your custom behavior durable across package updates.

Troubleshooting

nmem not found: Install with pip install nmem-cli, pipx install nmem-cli, or on Arch Linux yay -S nmem-cli / paru -S nmem-cli.

Server not running: Start the Nowledge Mem desktop app, or run nmem serve on your server.

Remote setup: Create ~/.nowledge-mem/config.json with {"apiUrl": "...", "apiKey": "..."}, or set NMEM_API_URL and NMEM_API_KEY environment variables. The extension uses the same config for automatic thread sync.

Check status: Ask Pi to run the status skill, or run nmem status directly.

Extension diagnostics: Automatic sync failures retry on a later lifecycle event without writing raw diagnostics into Pi's interactive editor. Set NMEM_PLUGIN_DEBUG=1 before starting Pi when troubleshooting the extension itself.

Links

• Documentation
• All Connectors
• GitHub

Made with care by Nowledge Labs