Commands: For agents

These commands are what a coding agent uses: the MCP server, the skill, the journal, reconcile and compile.

Generated from the --help of rabbit-brain 0.8.0.

rb mcp

serve the record to an agent over MCP (stdio); every call is recorded as the agent’s

usage: rb mcp [-h] [--agent AGENT]

options:
  -h, --help     show this help message and exit
  --agent AGENT  the agent's name in the record (default: the MCP client's
                 name)

rb skill

print the agent skill; rb skill add installs it for your coding agent

usage: rb skill [-h] [--json] [--claude] [--project] [--cursor] [--agents-md]
                [--yes]
                [{add}]

positional arguments:
  {add}                 add: write it where the agent looks

options:
  -h, --help            show this help message and exit
  --json                print one JSON object (the envelope) instead of text
  --claude              ~/.claude/skills/rabbit-brain/ (the default target)
  --project             with --claude: this project's .claude/skills/ instead
                        of the home directory
  --cursor              .cursor/rules/rabbit-brain.mdc in this project
  --agents-md, --codex  a marked section in this project's AGENTS.md, for
                        Codex and anything else that reads it
  --yes                 with --agents-md: add rb's section to an AGENTS.md
                        that is here without asking (default: asked once in
                        your terminal; elsewhere left as it is, with what to
                        add)

rb journal

what rb observed in the repository: files that appeared, git moves, wrapped commands

usage: rb journal [-h] [--json] [-n N] <scan|run> ...

positional arguments:
  <scan|run>
    scan      look at the watched places once and journal what changed
    run       run a command and journal what it did: rb journal run -- python
              eval.py ...

options:
  -h, --help  show this help message and exit
  --json      print one JSON object (the envelope) instead of text
  -n N        how many entries (default 20)

rb journal scan

usage: rb journal scan [-h] [--json] [--hook <agent>]

options:
  -h, --help      show this help message and exit
  --json          print one JSON object (the envelope) instead of text
  --hook <agent>  run from that agent's session hook (rb init installs it):
                  say nothing, exit 0, and keep the look as that agent's

rb journal run

usage: rb journal run [-h] [--json] ...

positional arguments:
  cmd         the command, after --

options:
  -h, --help  show this help message and exit
  --json      print one JSON object (the envelope) instead of text

rb reconcile

compile the repository against the record: each results folder with a report as an experiment, what its files say (verbatim), its checks, how to reproduce it; --apply keeps it

usage: rb reconcile [-h] [--json] [--apply] [--no-agents] [--yes]

options:
  -h, --help   show this help message and exit
  --json       print one JSON object (the envelope) instead of text
  --apply      keep it in the record: add and re-index the experiments, record
               the runs found, attributed to you
  --no-agents  with --apply where there is no record yet: leave the agents'
               instruction files alone (default: install rb's, as rb init
               does)
  --yes        with --apply where there is no record yet: add rb's part to an
               AGENTS.md or .mcp.json that is here without asking (default:
               asked once in your terminal; elsewhere left as they are)

rb compile

list what existing reports and results files the record can place, and what it cannot; writes nothing

usage: rb compile [-h] [--json] [paths ...]

positional arguments:
  paths       files or directories to compile from

options:
  -h, --help  show this help message and exit
  --json      print one JSON object (the envelope) instead of text