What is a shared project brain?

A set of durable markdown files — decisions, open tasks, preferences — that every coding agent on your team reads and updates. Unlike chat memory, it is human-readable, versioned, and the same across Cursor and Claude Code.

How is ReadmeDB different from Mem0 or other AI memory products?

Mem0 and similar tools extract and retrieve chat facts via vectors. ReadmeDB stores structured project files over MCP. Use Mem0 for personalized conversation memory; use ReadmeDB when you want agents to share a living decisions.md across tools. See https://app.readmedb.com/compare/mem0.

Does ReadmeDB replace CLAUDE.md or Cursor rules?

No. Keep CLAUDE.md and Cursor rules for local standards. Use ReadmeDB for the cross-tool, cloud-shared brain — especially open tasks and decisions that must survive switching editors. Guides: /solutions/claude and /solutions/cursor.

Which AI tools does ReadmeDB work with?

Any MCP-compatible host: Claude Code, Cursor, Windsurf, Codex CLI, Claude Desktop, and more. One API key is one file namespace shared across those tools.

What is MCP (Model Context Protocol)?

MCP is an open standard by Anthropic that lets AI agents connect to external tools and data sources. ReadmeDB implements a hosted MCP server so agents can read and write your project brain automatically. Details: https://app.readmedb.com/mcp.

Is there a free plan?

Yes. The free plan includes 50 files, 5 MB storage, 3 API keys, and 60 requests/minute. No credit card required. The Pro plan is £5/month for unlimited files, 50 GB storage, and unlimited keys.

Can teams share one project brain?

Yes. Point every teammate’s Cursor and Claude configs at the same ReadmeDB namespace so agents read the same decisions and open tasks. See https://app.readmedb.com/for-teams.

readmedbmcp

Agent-writable files · 16 MCP tools · Free to start

readmedb

Stop starting over every session.

Agents keep forgetting what you already decided. Store project truth as markdown they can read and write — synced across ChatGPT, Claude, Cursor, and Gemini.

Start free project brain →Install the CLI

Works withCursorClaude CodeWindsurfCodexAny MCP host

Writable truth. Not chat memory.

Cursor writes. Claude reads the same file.

Session 1 patches decisions.md. Session 2 — or another tool — loads it via MCP. Hosted markdown your agents update, with version history so truth doesn't live in one chat.

# mcp.json

"readmedb": {

"url": "app.readmedb.com/api/mcp",

"auth": "Bearer rdb_…"

}

Connect your agent →

One brain across every tool you use.

Cursor → Claude Code → chat shouldn't mean re-explaining the repo. Preferences, decisions, open tasks — paste or MCP-load anywhere.

open-tasks.md

- [ ] finish onboarding flow

+ [x] shared via readmedb

↳ read by 2 agents · 4 min ago

See MCP setup →

Demo

45 seconds. Cursor → Claude. Same brain.

Loom slot — drop the recording URL when ready. Until then: write in one tool, read in another, no paste ritual.

Video coming soon · replace with Loom embed

Three steps. Any agent.

Write your context

Store agent rules, task queues, preferences, and decisions as plain markdown files you control.

# preferences.md

— concise answers, bullet points

✓ versioned · searchable

Agents read and write

Connect via MCP for automatic access. Cursor, Claude Code, and Windsurf get 23 tools — files, memories, diff, restore.

write_file → decisions.md

read_files → open-tasks.md

or paste into any AI chat

Truth stays synced

Every update is versioned. Diff, inspect, or restore. No embeddings, no black box — just files your agents keep writing.

› get_file_history("decisions.md")

↳ v4 · today

↳ v3 · 2 days ago

23 MCP tools. Zero ceremony.

Write

Plain markdown your agents update — notes, decisions, rules.

write_fileappendpatchmovedelete

Find

Full-text search and bulk reads without re-reading the vault.

searchreadlistfetch for task

History

Every file keeps full version history. Inspect or roll back.

historydiffrestoreread version

Full reference: all 23 tools →

Shared files. Every agent.

readmedb

✓Works with any AI — agents or chat
✓You write and control every file
✓Readable, editable, versionable
✓MCP for agents, copy-paste for everyone
✓No embeddings, no black box

AI built-in memory

~Vendor-controlled, opaque
~Works within one AI only
✗Different memory in ChatGPT vs Claude
✗Can't see exactly what's stored
✗No version history

Copy-pasting notes

~Free, no setup
~You control the content
✗Manual every single session
✗No versioning or search
✗Scattered across docs and files

Free until you outgrow it.

Free

£0forever

No card required.

3 API keys
50 files total
5 MB storage
Last 10 versions per file

Start free brain

Pro

£5/ month

Room for a real project brain + sharing.

Unlimited API keys
Unlimited files
50 GB storage
Version history forever

Upgrade project brain

Need more? Enterprise plans available — contact us.

Common questions

Shared project brain. Every agent.

Start free project brain →Install the CLI

Free plan · 50 files · No card · Agents read and write