brainclaw + Claude Code

First-class integration with native docs, MCP, and session hooks.

brainclaw detects Claude Code automatically and generates CLAUDE.md with your project's live constraints, decisions, and known traps. It configures workspace MCP via .mcp.json for real-time context queries, installs a dedicated slash command for in-session coordination, and wires up session hooks so claims and plans stay synchronized across every conversation.

Install via Claude Code

Paste this prompt directly into Claude Code and let it handle the setup.

Please install and initialize brainclaw in this project.

Run: npm install -g brainclaw && brainclaw init

This sets up shared workspace memory, writes CLAUDE.md, configures MCP, installs the brainclaw slash command, and enables session hooks. Commit the generated files to Git.

Auto-setup

Run one command. brainclaw detects Claude Code and writes its native files automatically, including CLAUDE.md.

npm install -g brainclaw && brainclaw init

Detection: CLAUDE_CODE_VERSION env var.

What gets generated

After running brainclaw init, these files are created or updated:

CLAUDE.md
.mcp.json
.claude/commands/brainclaw.md
.claude/settings.local.json
.brainclaw/

Session hooks

Claude Code supports session hooks. brainclaw registers hooks that automatically export context at session start and record a snapshot at session end - keeping memory fresh across every run.

 brainclaw context --digest  # injected at session start
 brainclaw export --detect   # run at session end 

MCP integration

brainclaw configures MCP in .mcp.json, giving Claude Code dynamic access to workspace context via MCP tools.

 bclaw_work - open a session and claim scope in one call
 bclaw_context - ranked prompt-ready context
 bclaw_create / bclaw_update - capture decisions and traps, evolve plans
 bclaw_release_claim - close the claim and write a handoff 