Skip to content

README.md

Latest commit

 

History

History
76 lines (53 loc) · 2.24 KB

README.md

File metadata and controls

76 lines (53 loc) · 2.24 KB

agentmemory

 agentmemory for pi

Your pi sessions remember everything. No more re-explaining.
Persistent cross-session memory via agentmemory — shared with Claude Code, Codex CLI, Gemini CLI, Hermes, OpenClaw, and more.

Quick setup

Start the agentmemory server in a separate terminal:

npx @agentmemory/agentmemory

Copy this folder into pi's global extensions directory:

mkdir -p ~/.pi/agent/extensions/agentmemory
cp integrations/pi/index.ts ~/.pi/agent/extensions/agentmemory/index.ts

Then enable it in ~/.pi/agent/settings.json if you prefer explicit loading:

{
  "extensions": ["~/.pi/agent/extensions/agentmemory"]
}

If you place it under ~/.pi/agent/extensions/agentmemory/, pi will also auto-discover it and /reload can hot-reload it.

What it adds

  • memory_health — confirm the shared memory server is reachable
  • memory_search — search prior decisions, bugs, workflows, and preferences
  • memory_save — write durable facts back to long-term memory
  • /agentmemory-status — check health from inside pi
  • before_agent_start recall — injects relevant memories into the prompt
  • agent_end capture — saves completed conversation turns back to agentmemory

Environment variables

Variable Default Description
AGENTMEMORY_URL http://localhost:3111 agentmemory server URL
AGENTMEMORY_SECRET (none) Bearer token for protected instances

Smoke test

Run pi and ask it to use the memory_health tool, or call the command directly:

/agentmemory-status

You should see agentmemory healthy and a footer status like 🧠 agentmemory.

Notes

  • This extension uses pi's extension API, not MCP, so it can hook directly into the agent lifecycle.
  • One local agentmemory server can be shared across pi, pi2, Hermes, OpenClaw, Claude Code, Codex CLI, and Gemini CLI.

See also