CLAUDE.md and auto memory keep one tool, one machine in sync — but the moment you switch to Cursor, or open the same repo on another machine, that truth doesn't follow. ReadmeDB is the shared project brain Claude Code and Cursor both read and write via MCP, so decisions don't diverge across tools.
Project (or user) markdown Claude loads at session start — architecture, commands, conventions. Commit it to git so humans and other tools can read the static briefing.
Notes Claude writes while you work (preferences, project facts). Powerful inside Claude Code — invisible to Cursor, Codex, and teammates’ agents.
~/.claude/projects/…/memory/Keep standards in CLAUDE.md. Put the living brain in ReadmeDB:
Optional: add one line in CLAUDE.md telling Claude to call get_namespace_summary / read those files at session start.
{
"mcpServers": {
"readmedb": {
"url": "https://app.readmedb.com/api/mcp",
"headers": {
"Authorization": "Bearer rdb_your_key"
}
}
}
}Same block works in Cursor. One API key = one namespace = one project brain. Free tier available; Pro is £5/mo when you outgrow it.
Start free — Claude + Cursor shared brain →