Troubleshooting
Global matrix. Feature pages also list local tips under Troubleshooting.
| Symptom | Fix |
|---|---|
command not found |
Put ~/.local/bin on PATH — Install |
| Exit 4: daemon down | statefulmemory daemon force-start |
| Exit 5: no project | Run in a git repo, or export STATEFULMEMORY_PROJECT=… |
| MCP missing in agent | statefulmemory install, then fully restart the agent — Agents |
| Hybrid search empty | statefulmemory obs reindex — Search and context |
| Anchored note marked unprovable | Save/verify from a git work tree — Anchors and verify |
| Context missing old anchored claims | Expected when verify marked them stale; use --include-stale or verify.serve_stale = true |
decide / extract / conflict fails |
Install an agent CLI on PATH, or set STATEFULMEMORY_LLM_BIN / STATEFULMEMORY_LLM_PROVIDER — Decide |
| Git hooks not installed | Run statefulmemory install inside the repo (or omit --no-git-hooks) |
.mem decrypt fails |
Wrong seed file / phrase — Mem archives |
| Start over | statefulmemory daemon stop && rm -rf ~/.statefulmemory/ |
statefulmemory doctor [--repair]statefulmemory logs --lines 50statefulmemory daemon statusstatefulmemory verify