pi-agent-memory-bridge

持久记忆，随拿随用。 一个为 pi-coding-agent 打造的自我维护记忆扩展。自动记录你的每轮对话、工具调用与助手回复，跨会话、跨引擎调用同一份可搜索记忆。

This is the pi adapter of the agent-memory-bridge project — a bridge that gives every AI coding agent you use (OpenCode, CodeBuddy, pi, Hermes) one shared memory.

✨ Highlights

| 亮点 | 说明 | |:--|:--| | 🔄 多 Agent 适配 | 与 OpenCode / CodeBuddy / Hermes 共享同一记忆库，pi 里记的，其它 agent 也能搜到 | | 🚀 一键安装 | pi install npm:pi-agent-memory-bridge 一条命令，npm 市场直接装 | | 📥 自动捕获 | 自动记录用户提问、工具调用、助手回复、会话结束，零手动操作 | | 🔌 后端可拔插 | 底层可切换 claude-mem / mem0 / both，一个环境变量搞定 | | 🌐 中英双语 | 中英双语文档 |

Install (npm registry)

# 1. make sure the worker is up
curl -s http://127.0.0.1:37701/api/health

# 2. install from the npm registry (recommended)
pi install npm:pi-agent-memory-bridge

#    or install from source (local path):
cd /path/to/agent-memory-bridge/agents/pi
pi install "$PWD"

pi install appends the package to the packages array of ~/.pi/agent/settings.json:

{
  "packages": [
    "npm:pi-agent-memory-bridge"
  ]
}

Restart pi. At startup it logs the resolved worker URL, e.g. [pi-claude-mem] worker → http://127.0.0.1:37701 (端口来源: settings.json). Then run the /memory-status slash command — it should report the worker version and degraded: false.

Uninstall

pi remove npm:pi-agent-memory-bridge

then restart pi.

How it works

pi-coding-agent
   └── this extension (extensions/pi-claude-mem.ts)
        session start      local session id / project name
        before agent start -> POST /api/sessions/init        (with prompt)
        context            -> GET  /api/context/inject
        tool result        -> POST /api/sessions/observations (fire-and-forget)
        agent end          -> POST /api/sessions/summarize
        memory_recall tool -> GET  /api/search
        /memory-status     -> GET  /api/health
                              │
                              ▼
                local claude-mem worker (default 127.0.0.1:37701)
                SQLite (FTS5) + Chroma, shared across engines

Every observation is tagged platformSource: "pi-agent".

It is a thin client for the local claude-mem worker HTTP API: it records tool activity to the worker, injects relevant past context each turn, and registers a memory_recall search tool. pi itself does no summarization — the worker at 127.0.0.1:37701 handles summarization, embeddings and vector search.

This is a fork, not an independent reimplementation. It derives from the ArtemisAI [email protected] adapter, which itself derives from the OpenClaw plugin shipped with claude-mem. See NOTICE for the full provenance and the list of modifications.

Configuration

| Variable | Default | Description | |---|---|---| | CLAUDE_MEM_HOST | 127.0.0.1 | Worker host | | CLAUDE_MEM_PORT | 37777 (fallback) | Worker port; the extension also reads CLAUDE_MEM_WORKER_PORT from ~/.claude-mem/settings.json (accepts both number and numeric-string) | | CLAUDE_MEM_DATA_DIR | ~/.claude-mem | Worker data dir (where settings.json is read from) | | PI_MEM_PROJECT | derived from cwd (pi-<dir>) | Project grouping for observations | | PI_MEM_DISABLED | — | Set to 1 to disable the extension |

Resolution order for the port: CLAUDE_MEM_PORT env → CLAUDE_MEM_WORKER_PORT in ~/.claude-mem/settings.json → fallback 37777.

The runtime only imports the two peer modules pi injects (@mariozechner/pi-ai, @mariozechner/pi-coding-agent) plus Node built-ins, so the directory needs no node_modules. The @earendil-works pi distribution exposes compatible extension APIs and loads the package as-is.

License

AGPL-3.0-or-later — see LICENSE. The original copyright and notices must be retained. Note this is stricter than the rest of agent-memory-bridge, which is MIT; this agents/pi/ subdirectory is a self-contained AGPL-licensed component.

The claude-mem worker backend is a separate program (Apache-2.0) that this extension only talks to over a local HTTP API; it is neither contained in nor published by this package.

For a from-scratch machine setup (installing pi, the worker and the AI provider) see DEPLOY.md.