Skip to main content

Capture memory

pmb note

Jot a memory from the terminal. --pin keeps it forever; --ttl 30d auto-expires it.
pmb note "decided to use Postgres for JSONB" --pin

pmb learn

Record a durable lesson. --failed records a failure to avoid repeating.
pmb learn "always run make fmt before committing"

pmb fact

Record a standalone fact. --ttl 30d optional.
pmb fact "the staging DB is read-only"

pmb remember

Store a question / answer pair.
pmb remember "deploy command" "make deploy ENV=prod"

pmb import

Import existing history and rebuild the graph after. Sources: chatgpt, claude, mem0, markdown (Obsidian vault).
pmb import chatgpt ~/Downloads/conversations.json

pmb watch

Auto-capture new paragraphs from a notes file or folder. --once for cron.
pmb watch ~/notes/daily.md

Project tracking

A semantic layer over pmb index project: the structural index says which symbols exist, this says why a file exists and why it changed. Local, idempotent.

pmb track changes

Summarise the intent of new git commits and link it to the files touched. Idempotent via a per-repo cursor. Flags: --since, --max-commits, --backend.
pmb track changes

pmb track modules

A one-line “what this file does” per indexed file. Run pmb index project first. Flags: --limit, --force.
pmb index project . && pmb track modules

pmb track install

Install a git post-commit hook so track changes runs automatically (background, non-blocking, never clobbers an existing hook).
pmb track install

Resume note

A committable markdown snapshot of “where we are now”, sourced from PMB’s typed memory.

pmb resume save

Write the resume note now. --path .pmb/resume.md to choose the location.
pmb resume save

pmb resume show

Print the current resume note.
pmb resume show

pmb resume install

Enable auto-refresh at every turn end (Stop hook). Hand-edited additions below the PMB-RESUME-MARKER line are preserved across regenerations.
pmb resume install