Skip to content

Connect your agent

rb init installs rb’s instructions for each agent it finds in the repository. It asks before it changes a file you already have, and --yes answers up front. Where it cannot ask, it leaves the file alone and names the command to run. rb init --dry-run lists what it would write. rb with Claude Code, Codex and Cursor shows both with real output.

When it finds .claude/, CLAUDE.md or a Claude Code session, rb init installs:

  • the skill, in .claude/skills/rabbit-brain/SKILL.md
  • rb’s MCP server, in .mcp.json
  • rb’s session hook

To add them later:

Terminal window
rb skill add --claude --project
claude mcp add --scope project rabbit-brain -- rb mcp

Then start a new session.

  • rb context prints the record as one briefing. The skill tells the agent to run rb context --model <your model id> first.
  • rb mcp serves the same commands as MCP tools.

rb’s session hook runs rb journal scan --hook <agent> as a session starts and as each turn ends, so rb looks at the repository even when the agent skips rb’s instructions. It prints nothing and has a 10-second limit. rb notes the scan in its journal, not in the record.

AgentWhere
Claude CodeSessionStart and Stop, in .claude/settings.json
CodexSessionStart and Stop, in .codex/hooks.json
CursorsessionStart and stop, in .cursor/hooks.json

rb’s handler goes beside your other hooks, which stay as they are.

On Windows, Claude Code needs Git Bash to run the hook. Without it the hook fails, but the session goes on. Cursor’s hook and Codex’s on Windows look for rb on the PATH alone.

rb records who made each write. A call is a decision on a result (accept, reject, investigate) or on a line of work (continue, park, stop, pivot, ship). Calls are yours. A call recorded in an agent session is proposed, not made, until you approve it with rb confirm in your own terminal. rb refuses rb confirm in an agent session. An experiment design an agent wrote reads “design not confirmed” until you approve it the same way. Calls has the details.

Rabbit Brainrabbitbrain.ai · GitHub · PyPI · Privacy · Apache-2.0