Supported agents
pmb connect <agent> wires 9 agents, in three tiers by integration depth.
Full hooks
Claude Code - all 4 lifecycle hooks: auto-recall before each message,
ambient write, session restore, follow-through.
Ambient hooks
Codex (OpenAI) - MCP plus ambient write (rollout + notify); no per-turn
read hook, so it inherits the default tool surface.
MCP only
Cursor · Windsurf · Gemini CLI · VS Code · Zed · OpenCode · Continue -
memory via tools; ambient optional via a git observer.
Only Claude Code and Codex install hooks. The rest are pure MCP: memory works,
but the agent “remembers” via explicit tool calls and the rules appended to
CLAUDE.md / AGENTS.md, not automatically before each turn.Tool profiles
PMB trims the tool list so a fresh agent isn’t drowned in choices. SetPMB_TOOL_PROFILE, or let pmb connect pick one.
| Profile | Tools | For |
|---|---|---|
minimal | 10 | The default. The core memory loop. |
lean | 30 | default minus hook-covered browse tools. |
default | 34 | Fuller day-to-day set. Opt in. |
full | ~65 | Everything, incl. maintenance/admin. |
The core-10 (default surface)
prepare
One read-first call at task start: project context, lessons, recent
activity, open goals.
recall
Hybrid semantic + lexical search over memory.
record_batch
The single write path - facts, goals, activities in one call.
record_keyed_fact
Upsert a mutable personal attribute (city, employer…).
find_lessons / mark_lesson_followed
Surface procedural rules and close the self-improvement loop.
project_overview
Graph-driven full context for a named project.
session_brief
Re-orient after your context compacted.
list_goals / update_goal
See and move what’s in flight.