pi-agent-memory

Fork & adaptation of claude-mem (55k+ stars, 4.4k+ forks) — the most popular persistent memory system for AI coding agents — now available as a native pi-mono extension.

Gives pi-coding-agent and any pi-mono-based runtime cross-session, cross-engine memory by connecting to claude-mem's battle-tested worker service. Same compressed memory, same hybrid search (FTS5 + Chroma vector embeddings), same cross-engine sharing — built for pi-agents.

Why pi-agent-memory?

• Backed by claude-mem — the #1 memory system for AI coding agents, trusted by 55k+ developers
• Cross-engine memory — your pi-agent shares memory with Claude Code, Cursor, Codex, and OpenClaw sessions
• Hybrid search — FTS5 full-text + Chroma vector embeddings for precise memory recall
• Zero config — installs with one command, auto-connects to the claude-mem worker
• Battle-tested — built on the same worker API powering thousands of daily sessions

Installation

Requires the claude-mem worker running on localhost:37777. Install claude-mem first via npx claude-mem install or run the worker from source.

From npm (recommended)

pi install npm:pi-agent-memory

From git

pi install git:github.com/thedotmack/claude-mem

Manual

cp extensions/pi-mem.ts ~/.pi/agent/extensions/pi-mem.ts

Verify

# Start pi — the extension auto-loads
pi

# Check connectivity
/memory-status

What It Does

• Captures observations — every tool call your pi-agent makes is recorded to claude-mem's database
• Injects context — relevant past observations are automatically injected into the LLM context each turn
• Memory search — a memory_recall tool is registered for the LLM to explicitly search past work
• Cross-engine sharing — pi-agent observations live alongside Claude Code, Cursor, Codex, and OpenClaw memories in the same database

Architecture

Pi-Agent (pi-coding-agent / OpenClaw / custom)
    │
    ├── pi-mem extension (this package)
    │   ├── session_start      ──→  (local state init only)
    │   ├── before_agent_start ──→  POST /api/sessions/init (with prompt)
    │   ├── context            ──→  GET  /api/context/inject
    │   ├── tool_result        ──→  POST /api/sessions/observations
    │   ├── agent_end          ──→  POST /api/sessions/summarize
    │   │                           POST /api/sessions/complete
    │   ├── session_compact    ──→  (preserve session state)
    │   └── session_shutdown   ──→  (cleanup)
    │
    └── memory_recall tool     ──→  GET  /api/search
                                         │
                                         ▼
                            claude-mem worker (port 37777)
                            SQLite + FTS5 + Chroma
                            Shared across all engines

Event Mapping

| Pi-Mono Event | Worker API | Purpose | |---|---|---| | session_start | — (local state only) | Derive project name, generate session ID | | before_agent_start | POST /api/sessions/init | Capture user prompt for privacy filtering | | context | GET /api/context/inject | Inject past observations into LLM context | | tool_result | POST /api/sessions/observations | Record what tools did (fire-and-forget) | | agent_end | POST /api/sessions/summarize + complete | AI-compress the session | | session_compact | — | Preserve session ID across context compaction | | session_shutdown | — | Clean up local state |

Derived from the OpenClaw plugin (claude-mem/openclaw/src/index.ts), which is a proven integration of claude-mem into a pi-mono-based runtime.

Configuration

| Variable | Default | Description | |---|---|---| | CLAUDE_MEM_PORT | 37777 | Worker service port | | CLAUDE_MEM_HOST | 127.0.0.1 | Worker service host | | PI_MEM_PROJECT | (derived from cwd) | Project name for scoping observations | | PI_MEM_DISABLED | — | Set to 1 to disable the extension |

Cross-Engine Memory

All engines write to the same ~/.claude-mem/claude-mem.db, tagged by platform_source:

| Engine | Platform Source | |---|---| | Claude Code | claude | | OpenClaw | openclaw | | Pi-Agent | pi-agent | | Cursor | cursor | | Codex | codex |

Context injection returns observations from all engines for the same project by default. Pass platformSource to filter by engine.

Related Packages

Other independent claude-mem adapters published to npm:

• @ephemushroom/opencode-claude-mem — OpenCode adapter (MIT)
• opencode-cmem — OpenCode adapter (MIT)

Other pi memory extensions (standalone, not claude-mem based):

• @samfp/pi-memory — Learns corrections/preferences from sessions
• @zhafron/pi-memory — Memory management + identity
• @db0-ai/pi — Auto fact extraction, local SQLite

Development

# Edit the extension
vim extensions/pi-mem.ts

# Test locally
pi -e ./extensions/pi-mem.ts

# Or install from local path
pi install ./pi-agent

Credits

This package is a fork and adaptation of claude-mem by @thedotmack — the leading persistent memory system for AI coding agents. All core memory infrastructure (worker service, SQLite + FTS5 database, Chroma vector embeddings, AI-powered compression) is provided by claude-mem.

License

AGPL-3.0 — same as claude-mem.