brainclaw + Codex

Shared context that persists across sandboxed runs.

brainclaw writes AGENTS.md so every Codex run inherits your project's coordination state — constraints, active plans, and known traps — even inside sandboxed execution environments. Optional machine-local MCP via config.toml enables dynamic context retrieval for runs that need the latest workspace state.

Install via Codex

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

Please run: npm install -g brainclaw && brainclaw init

This sets up brainclaw workspace coordination and writes AGENTS.md so future Codex runs inherit the same shared context.

Auto-setup

Run one command. brainclaw detects Codex and writes its native files automatically, including AGENTS.md.

npm install -g brainclaw && brainclaw init

Detection: ~/.codex directory.

What gets generated

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

AGENTS.md
~/.codex/config.toml
.brainclaw/

MCP integration

brainclaw configures MCP in ~/.codex/config.toml, giving Codex 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 