What is brainclaw?
Shared memory & coordination for coding agents
brainclaw runs beside Claude Code, Codex, Cursor & co — not instead of them. It gives your agents what they lack natively: durable project memory and a coordination layer, so they stop forgetting, overlapping, and starting from scratch each session.
How it works
- brainclaw init
Scaffolds .brainclaw/ in your repo, writes the native instruction file your agent reads, and builds the Code Map index so agents know where things live before they grep.
- Agents work over MCP
Each agent loads the shared context, asks the Code Map what to read before editing, claims the scope it touches, and records decisions and traps as it goes.
- Handoff & release
When it finishes it leaves a handoff and releases the claim — the next agent (or you, tomorrow) resumes from a clean shared state.
Not a memory server. Files in your repo. No account, no backend.
The agent is the user.
You don't run brainclaw at a prompt — your coding agent does, over MCP. It reads the project's shared memory, asks the Code Map what to read, and writes back what it learns. You just say what you want.
bclaw_work. Every plan, decision, trap and sequence lives in .brainclaw/, versioned in git — exposed as MCP tools to any agent (Claude, Codex, Copilot…), or as a CLI when you want one. The agent picks up the project; you don't re-explain it.
Adopt brainclaw.
brainclaw is open-source and shipping fast. One install, every agent in your repo sees the same shared memory.
Available on npm. No signup, no telemetry.
- MIT licensed
- Open source
- Local-first
- No telemetry
Paste this prompt to your coding agent. It looks up brainclaw, installs it, and initializes or joins this repo on your behalf.
Please look up brainclaw on https://www.npmjs.com/package/brainclaw to understand what it does. Then install it on this machine (npm install -g brainclaw) and set it up for this repo: - If .brainclaw/ already exists, the existing setup activates as soon as the package is installed. - Otherwise, run brainclaw init to scaffold shared memory, plans, claims, and the native instruction file. Commit any generated files.
npm install -g brainclaw brainclaw init Joining an existing brainclaw repo? Step 1 is all you need — the existing .brainclaw/ activates on the next agent session, no init required.
