Quickstart

Cerebe reviews what your coding agent writes — on the workstation as you commit, and on the hosted Platform as an independent panel on every pull request. This is the short path from install to a required check.

The CLI is free to run on any repository. Plans and pricing for the hosted Platform are on the pricing page.

1. Install the CLI

Use the installer below to install the Cerebe CLI.

curl -fsSL https://cerebe.ai/install.sh | sh

The one line writes cerebe/config.json, cerebe.yaml, AGENTS.md, and CLAUDE.md, arms the git hooks, and runs cerebe doctor. It does not auto-enable critics. Day one is 0 critics, quorum 0; review / gate-push skip when the fleet is empty. An empty fleet is OK.

Local review is opt-in:

cerebe model add cursor    # or claude, codex, gemini, kimi

2. Get your first review

After cerebe model add, make a change with your agent, commit it, and watch the critic run:

git commit -m "feat: ..."   # post-commit starts the review in the background
cerebe watch                # follow the factory floor for this branch
cerebe show --commit HEAD   # read the full per-commit verdict

The workstation critic reads your repo's rules and reviews the diff. Findings at blocker or high hold your next push; lower severities are recorded and do not block. With no critic enabled, the commit and push go through without a local verdict.

3. Push through the gate

git push   # with a fleet: needs a completed review with no blocker/high findings

If the gate blocks you, fix the finding in a new commit — never amend. The verdict is bound to the original commit and its diff, so an amend detaches the evidence rather than clearing it. A blocked push can only proceed with a named, recorded reason. An empty fleet does not fail closed on a missing verdict.

4. Require the check on your pull requests

The workstation critic is a convenience; the authority is the hosted Platform. Install the Cerebe GitHub App on the repository. It posts its verdict on every pull request as the cerebe/critic check. To require it, add cerebe/critic to the repository's required status checks. The steps, and when the verdict blocks a merge, are in Require the check.

Troubleshooting

The CLI is a compiled binary. If you installed an npm or pip package instead, see Troubleshooting.