Connect your agent

pmb connect claude-code   # or cursor, codex, windsurf, gemini, vscode, zed, opencode, continue

pmb connect writes the agent’s MCP config and appends the usage rules to CLAUDE.md / AGENTS.md. Restart the agent and memory is live.

Three tiers of integration

Full hooks

Claude Code - auto-recall before each message, ambient write, session restore, follow-through. Memory works without calling a tool.

Ambient hooks

Codex - MCP plus ambient write on turn-complete; no per-turn read hook.

MCP only

Cursor · Windsurf · Gemini · VS Code · Zed · OpenCode · Continue - memory via tools; ambient optional via pmb ambient-watch.

Useful flags

pmb connect cursor --workspace personal   # share one memory across agents
pmb connect codex --active                # proactive logging (agent records its own work)
pmb connect --list                        # every agent + where its config lives
pmb connect claude-code --probe           # confirm pmb-mcp starts after wiring

Prefer the all-in-one path: pmb setup (or pmb setup --all) detects your agents, picks the model, wires + warms + starts the shared daemon in one flow.

Remove it anytime

Delete the pmb entry from the agent’s MCP config to disconnect - your stored memory stays on disk and is still readable via the CLI.

Get started

Guides

Concepts

CLI reference

MCP & agents

Contributing

Connect your agent

Three tiers of integration

Full hooks

Ambient hooks

MCP only

Useful flags

Remove it anytime

​Three tiers of integration

Full hooks

Ambient hooks

MCP only

​Useful flags

​Remove it anytime

Three tiers of integration

Useful flags

Remove it anytime