Overview
statefulmemory
Section titled “statefulmemory”Persistent memory infrastructure for coding agents: CLI + MCP → gRPC daemon → per-project SQLite. Self-host on your machine or team, or use StatefulMemory Cloud (managed SaaS).
make install
wire with statefulmemory install
source on GitHub
Install in one minute
Section titled “Install in one minute”git clone https://github.com/sanudatta11/statefulmemory && cd statefulmemorymake prereqs && make installexport PATH="$HOME/.local/bin:$PATH"statefulmemory --versionUse it
Section titled “Use it”- Wire your agent —
statefulmemory install(orstatefulmemory install --agent cursor) - Save something useful —
statefulmemory obs save --type decision --title "…" --content "…"(add--anchor path::symbolfor code-tied claims) - Pull context later —
statefulmemory obs context --query "…" --limit 20
Full walkthrough: Getting started · Agent setup: Wire into your agent · Shipped vs wishlist: Integrations.
Works with Claude Code, Cursor, Windsurf, Antigravity, OpenCode, Kimi Code, ZCode, VS Code / Copilot, Codex, Gemini CLI, Amazon Q, and any agent that can shell out or speak MCP. There is no Python Memory SDK yet — use MCP or the CLI. Deployment: Self-hosting and Cloud.
For LLMs and AI crawlers
Section titled “For LLMs and AI crawlers”Machine-readable index: llms.txt · fuller summary: llms-full.txt. Coding agents cloning the repo should read AGENTS.md (OpenCode / Codex / local) or CLAUDE.md.
Guides
Section titled “Guides”- Why statefulmemorySelf-host + Cloud SaaS vs vector DBs alone.
- ArchitectureCLI, MCP, daemon, SQLite, workers.
- InstallBuild from source, PATH, and doctor.
- Getting startedEnd-to-end tour across every core surface.
- Wire into your agentMCP tools, git verify hooks, local LLM env.
- Integrations14 install targets shipped; frameworks not yet.
- Self-hosting and CloudUDS / team TCP self-host, or StatefulMemory Cloud SaaS.
- ObservationsSave, recent, history, reextract, reindex.
- Search and contextHybrid retrieval, token budgets, stale withdrawal.
- Anchors and verifypath::symbol digests and git hooks.
- DecideResolve conflicting memories with your agent CLI.
- Mem archivesPortable .mem export and import.
- ConfigOverlays, verify, decay, env overrides.
- LoCoMo evalMethodology; public wins wait on stratified runs.
- TroubleshootingDoctor, daemon, and common failures.
- Command cheat sheetDense index linking out to the guides above.