Your agent's chatin your repo
+ 11 more lines
Your AI agent records what was tried, what the results show, and what's still open, with the code and settings.
rb open to see the recordUse Rabbit Brain to keep track of the research in this repository. Record where the work stands now, from its own files. Set up: - If `rb --version` fails, install it with `uv tool install rabbit-brain` (or `pipx install rabbit-brain`). - If this repository has no `.rb/` yet, run `rb init "<the work's theme>"`, then add the question the work is trying to answer with `rb question add`. - Run `rb docs --start` and follow it. Run `rb context --model <your model id>` before anything else. Record from the repository's own files, and cite them: the questions, the experiments with each setting and where its value came from, the rules a result must meet, and the runs. Run new experiments through `rb journal run`. Never compute findings, rankings or regressions yourself: rb computes them. Calls on results are mine. Record one only when I ask, in my words, and give me the `rb confirm` command. If I want a page to share, run `rb page`: it writes the record's page as one file. If I want it in my rabbitbrain.ai account, run `rb login` (I approve its code myself) and then `rb sync`. Finish with `rb status` exactly as printed, what you recorded, what rb says needs me, and where the page is if you wrote one.
How it works
Your agent's chatin your repo
What your agent runsfor that question
rb init "INT8 ResNet-50"creates the .rb/ folder that holds the recordrb question add "Is INT8 ResNet-50 as good as FP32 on ImageNet?"writes down what you want to find outrb criterion add "INT8 adds at most 0.05 validation loss" ...sets the pass mark before any results existrb run add int8 --from out/seed1/metrics.json --set seed=1records each run from its metrics filerb statusshows the results so far and what waits for your decisionloss-budgetrule ≤ 0.05
criterion met · loss
change.val_loss: +0.01337 [+0.006287, +0.02045]
paired difference, t interval, 3 seeds, 95% (rb)
Loss may rise by at most 0.05. Across 3 seeds it rose 0.013, so it passes.
Receipts · rb tour3 runs
config out/s1/config.yaml: 2 match, 0 differ, 0 absent
rb stores a fingerprint of each run's metrics file, so a later change shows. It checks out/s1/config.yaml against your settings: 2 match, 0 differ.
Your callloss-budget
criterion met · loss$ rb decide loss-budget accept \ --why "within budget on all three seeds" dp3kmue: accepted loss-budget: within budget on all three seeds
If your agent accepts or rejects one, it waits until you confirm.
A linkrabbitbrain.ai/demo
A real study, run by an agent and recorded with rb.
The first three cards show output from rb tour, a small example project rb builds for you.
Under the hood
rb journal run, sets pass marks with rb criterion add and leaves notes with rb note add.rb context hands a new agent the questions, results and open problems. You read the same record in rb open, rb page or a shared link.rb confirm.Checked, not taken on trust
When the agent records a setting, rb looks it up in the config file it cites. If it isn't there, rb marks the setting as not checked.
The sample study cites the model's published score, 49.6%. Its own runs score the plain prompt at 13.1%, so rb marks that number as not reproduced.
If a pass mark was written after the scores came in, rb says so next to the result.
Accept, reject, park or ship: each one stores a name and a reason.
Share
rb sync puts the record in your private account on rabbitbrain.ai. You decide who gets the link, and you can turn it off.
Free and open source · plain files in your repo
Try Rabbit Brain on a sample study, so you don't need to set up any experiments or use your own research. Just open Claude Code or Codex in an empty folder and paste the prompt below.
Clone https://github.com/rabbit-brain/think-step-by-step and work inside it. Install rabbit-brain from PyPI into a virtual environment in that folder. It's open source: https://github.com/rabbit-brain/rb Start rb login in the background and show me the sign-in link it prints. I'll sign in. When I'm signed in, run rb sync and give me the link it prints. Run rb context and tell me in three lines what the study found and what's still open. Don't run any experiments.
rb page instead.To use rb on your own repository, start with the install guide.