Cavemem

cavemem

why agent forget when agent can remember

Install • How it works • CLI • MCP • Settings
Status: frozen (August 2026). cavemem is no longer in active development.
Everything below still installs and works, but expect no new features or
fixes. Its compressed-memory core lives on inside
caveman — the actively developed
home of the family, alongside
caveman-browse.

Cross-agent persistent memory for coding assistants. Hooks fire at session boundaries, compress observations with the caveman grammar (~75% fewer prose tokens, code and paths preserved byte-for-byte), and write to local SQLite. Agents query their own history through three MCP tools. No network. No cloud.

Supports: Claude Code · OpenCode · Codex · GitHub Copilot · Augment Code · Cursor (query-only) · Gemini CLI (query-only) · Antigravity (query-only) · IBM Bob (query-only)

- Persistent memory across sessions. Hooks capture what happened; the store keeps it.
- Compressed at rest. Deterministic caveman grammar, round-trip-guaranteed expansion for humans.
- Progressive MCP retrieval. search, timeline, get_observations — agents filter before fetching.
- Hybrid search. SQLite FTS5 keyword + local vector index, combined with a tunable ranker.
- Local by default. No network calls. Optional remote embedding providers via config.
- Web viewer. Read-only UI at http://localhost:37777 for browsing sessions in human-readable form. Token-protected: the worker generates a local bearer token on first start and injects it into the served page, so cavemem viewer still opens with zero friction while /api/* rejects requests without it.
- Cross-IDE installers. Claude Code, OpenCode, Codex, GitHub Copilot, Augment Code capture observations; Cursor, Gemini CLI, Antigravity, IBM Bob are query-only (MCP search over memory…