Skip to main content
Every command supports --help for its full flag list. Everything is offline unless tagged otherwise.

Setup

pmb setup [agent]

Recommended one-command setup. Detects your agent, picks the memory model, wires MCP + rules + hooks, warms the engine, and starts the shared daemon - in one guided flow. Omit agent to auto-detect.

pmb init [--name NAME]

Initialize a workspace in the current directory. Optional - a workspace auto-detects from cwd.

Connect an agent

pmb connect <agent>

Wire PMB into an agent’s MCP config and install its rules. Points at the shared daemon by default; --stdio keeps a per-client server.
Agents: claude-code, cursor, codex, windsurf, gemini, vscode, zed, opencode, continue.

Models & daemon

pmb model [light | balanced | best]

Switch the embedding model later: download, re-embed memory, and restart the daemon in one step. Omit the arg for the interactive menu.

pmb daemon start | stop | status | restart

Manage the one warm daemon (Engine + model + LanceDB) that N clients share for instant recall.

pmb mcp serve | status | proxy

Run a shared HTTP MCP server (team mode), list running servers + their RAM, or run the stdio↔daemon bridge (proxy, auto-wired for Codex).

Diagnose

pmb doctor

Diagnose the install and runtime state. --remote user@host:/path prints an SSH-tunneled MCP snippet.

pmb warmup

Pre-load the model + BM25 + LanceDB so the next recall is fast (avoids the ~1-2s cold start).