GUIDE · SHARED MEMORY
CLAUDE.md vs shared team memory: the honest breakdown
CLAUDE.md caps out around 2k tokens and lives in one checkout. See exactly what a shared memory layer adds for Claude Code teams — and keep your rules file anyway. Start free.
Rules files are steering; memory is history
Keep invariants (“always use the repository layer”) in CLAUDE.md. Put the reasoning, rejected alternatives, incident lessons, and customer constraints into versioned memory — the long tail no rules file was shaped to carry.
One checkout vs every machine
CLAUDE.md travels with a git clone. Memory follows the developer across machines, containers, and CI runners — synchronized deltas mean every session inherits the same briefing wherever it boots.
Personal notes vs organizational capital
Auto-memory helps one developer remember preferences. Team memory compounds: what anyone teaches Claude Code becomes searchable, pinnable, auditable context for every teammate and agent afterwards.
Keep both — wire them together
The winning setup is boring: short CLAUDE.md for invariants, MemHub for everything else, and a one-line pointer in CLAUDE.md telling agents to consult memory at session start. Ten minutes to set up.
UNIVERSAL COMPATIBILITY
Plugs into any CLI or development tool you use.
If it speaks MCP or reads a JSON config, MemHub plugs in. One command wires the majors; everything else joins as a generic client.
- Claude Code
- Cursor
- Windsurf
- Cline
- Codex CLI (GPT)
- GitHub Copilot
- Google Antigravity
- Gemini CLI
- Aider
- OpenCode
- CI bots via REST
Questions, answered straight.
Does Claude Code auto memory replace this?
No — auto memory is personal and machine-local. MemHub adds the shared, project-scoped, cross-machine layer with search and provenance that teams actually need.
Will old memories pollute my context window?
No. Briefings deliver the delta since each session’s last sequence, and retrieval ranks by topic and recency — the archive stays queryable, never bulk-loaded.
THE NEXT SESSION STARTS HERE
Your next session can start already briefed.