Install

The Cerebe Factory CLI runs on your workstation and is free to run on any repository. It is a compiled binary — not an npm or pip package. The hosted Platform is the independent panel on every pull request; see the GitHub App. You do not need the App to use the CLI. Plans and pricing are on the pricing page.

Install the CLI

# From the repo you want adopted.
curl -fsSL https://cerebe.ai/install.sh | sh

That one line downloads checksum-verified cerebe + cyclone binaries and configures this checkout (cerebe install, or cerebe init if already adopted). It writes cerebe/config.json, cerebe.yaml, AGENTS.md, and CLAUDE.md, arms git hooks, and runs cerebe doctor. It does not auto-enable a local critic fleet. Detected vendor CLIs are printed as a suggestion only. Day one is 0 critics, quorum 0. cerebe review and cerebe gate-push skip when the fleet is empty — pre-push does not block just because no verdict exists.

cerebe.yaml was previously named darkfactory.yaml. The CLI still reads a leftover darkfactory.yaml.

Reusable workflows stay binaries-only: they set CEREBE_INSTALL_DIR to an isolated temp dir. CI and CEREBE_SKIP_REPO=1 also skip repo setup.

Local review is opt-in:

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

Once a critic is enabled, the hooks do this:

• post-commit runs the critic in the background and writes a per-commit verdict.
• pre-push requires a completed review and blocks the push if that verdict has an open blocker or high finding. A blocked push needs a named, recorded reason.

On a repository that already has cerebe/ committed — a teammate's clone, or a new git worktree — the same curl runs cerebe init instead of cerebe install.

cerebe doctor already ran as the last step of the one-liner. An empty local fleet is OK. All-green does not mean the next commit will run a critic — that starts only after cerebe model add.

Windows

The install script runs on macOS and Linux and stops on Windows. On Windows, download the cerebe and cyclone .zip archives for your architecture from the Releases page, extract them, and put both binaries on your PATH. Then run cerebe install from the repository you want adopted, or cerebe init if it already has cerebe/ committed.

Pin a version

The install script installs the latest stable release. To install a specific release, set CEREBE_VERSION to its version number:

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

Troubleshooting

The Factory CLI is a compiled binary. If you used npm or pip, check which package you installed:

• npm i @momentiq/dark-factory-cli — deprecated frozen npm CLI
• npm i @cerebe/sdk or pip install cerebe — client SDKs for a separate Cerebe API, not the Factory CLI
• npm i @cerebe/cli — redirect stub that prints install.sh and exits 1

Use the installer from your repository:

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