CLI overview
Review agent-written code on your workstation before you open a pull request.
The CLI is free to run on any repository. A critic, a reviewer model you add, checks every commit against your repo's rules.
The hosted Platform provides an independent panel on every pull request,
the dashboard, and the cerebe/critic check (plans and pricing).
The loop
cerebe install arms two git hooks (see Install) but
does not enable critics. Local review starts after
cerebe model add cursor (or claude / codex / gemini / kimi). Until
then, review and gate-push skip. After you add a critic, the loop is:
git commit -m "feat: ..." # post-commit runs the critic in the background
cerebe watch # follow the review as it runs
git push # pre-push needs a completed review, blocks on blocker / highThe commands
| Command | What it does |
|---|---|
cerebe review | Run the local critic against a commit (the post-commit hook usually does this for you). |
cerebe watch | Live "factory floor" for this branch's review loop. |
cerebe status --commit HEAD | Terse verdict + per-critic status for one commit. |
cerebe show --commit HEAD | Render the full per-commit review artifact. |
cerebe findings --range origin/main..HEAD | Audit findings across a range (does not re-gate). |
cerebe stats | Summarize the critic audit trail, including overrides. |
cerebe doctor | Report armed hooks, detected agents, and config health. |
The critics
Local review is opt-in. cerebe install leaves critics[] empty. Add one with
cerebe model add <id>. After that, the local critic runs a multi-vendor
quorum using your own AI-app subscriptions — the CLIs you already run, such as
Claude Code, Codex, and Cursor. There are no API keys to manage; the fleet and
the quorum come from cerebe/config.json.