CerebeCerebe Docs
Cerebe Factory

Quickstart

Install the Cerebe CLI, get your first independent review, and require the check on your pull requests.

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. The hosted Platform — the pull request panel, the dashboard, and the required check — is the paid tier ($200 per developer / month; see pricing).

1. Install the CLI

curl -fsSL https://raw.githubusercontent.com/momentiq-ai/cerebe/main/install.sh | sh

cerebe --version
cerebe install

cerebe install scaffolds cerebe/, detects your local AI CLIs, and arms the git hooks. Run cerebe doctor to confirm the hooks are armed and your coding agents are detected.

2. Get your first review

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; everything below is advisory.

3. Push through the gate

git push   # pre-push 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.

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, let it post its verdict on every pull request, and require that check when you want it to gate merge.

On this page