brainclaw + Cursor

Auto-synced rules and MCP for always-fresh context.

brainclaw writes structured Cursor rules into .cursor/rules/ and adds an MCP shim rule that tells Cursor when and how to pull live workspace state. Machine-local MCP configuration means every Cursor session starts with current project constraints, active claims, and team decisions — no manual copy-paste required.

Install via Cursor

Paste this prompt directly into Cursor 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 coordination, writes .cursor/rules/brainclaw.md, adds the MCP shim rule, and configures Cursor MCP.

Auto-setup

Run one command. brainclaw detects Cursor and writes its native files automatically, including .cursor/rules/brainclaw.md.

npm install -g brainclaw && brainclaw init

Detection: CURSOR_* env vars.

What gets generated

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

  • .cursor/rules/brainclaw.md
  • .cursor/rules/brainclaw-mcp-shim.mdc
  • ~/.cursor/mcp.json
  • .brainclaw/

MCP integration

brainclaw configures MCP in ~/.cursor/mcp.json, giving Cursor 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

Ready to install?

npm install -g brainclaw && brainclaw init