Command cheat sheet

Prefer the feature guides for explanations. This page is a dense index only.

Install and agents

make prereqs && make install
statefulmemory install
statefulmemory install --agent cursor
statefulmemory install --no-git-hooks

→ Install · Wire into your agent

Observations

statefulmemory obs save --type decision --title "…" --content "…" --session "$SID"
statefulmemory obs save --anchor src/auth.rs::login --title "…" --content "…"
statefulmemory obs recent --limit 10
statefulmemory obs history <id>
statefulmemory obs relations <id>
statefulmemory obs reextract [--since <rfc3339>]
statefulmemory obs reindex [--force]

→ Observations

Search and context

statefulmemory obs search "auth"
statefulmemory obs search "auth" --mode bm25
statefulmemory obs search "auth" --max-tokens 800
statefulmemory obs context --query "deploy" --limit 20
statefulmemory obs context --max-tokens 500
statefulmemory obs context --include-stale

→ Search and context

Anchors and verify

statefulmemory verify
statefulmemory verify --quiet

→ Anchors and verify

Decide and mem

statefulmemory decide "Should we keep SQLite?"
statefulmemory mem export --out backup.mem
statefulmemory mem export --out secret.mem --seed-file ./phrase.txt
statefulmemory mem import backup.mem

→ Decide · Mem archives

Ops

statefulmemory config show
statefulmemory daemon status
statefulmemory doctor [--repair]
statefulmemory tui
statefulmemory logs --lines 50
statefulmemory eval --smoke --save-scorecard card.json

→ Config · LoCoMo eval · Troubleshooting

TTY → text; pipes → JSON. Override with --output {text,json,yaml}.