brainclaw + Windsurf

Workspace rules and machine MCP, always in sync.

brainclaw keeps .windsurfrules updated with your project's active constraints, known traps, and coordination decisions. Windsurf MCP is configured at the machine level so the Cascade agent can query live workspace state — active claims, plans, and cross-agent handoffs — directly from the editor.

Install via Windsurf

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

Please initialize brainclaw in this workspace: npm install -g brainclaw && brainclaw init

brainclaw adds shared project memory, writes .windsurfrules, and configures Windsurf MCP.

Auto-setup

Run one command. brainclaw detects Windsurf and writes its native files automatically, including .windsurfrules.

npm install -g brainclaw && brainclaw init

Detection: WINDSURF_* env vars.

What gets generated

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

.windsurfrules
~/.codeium/windsurf/mcp_config.json
.brainclaw/

MCP integration

brainclaw configures MCP in ~/.codeium/windsurf/mcp_config.json, giving Windsurf 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 