Installation

baro ships as an npm package called baro-ai. The published artifact bundles the CLI binary (Rust) and the TypeScript orchestrator together — one install gets you both.

Prerequisites

• Node 20+ for the npm install path.
• An LLM provider. baro 0.38+ runs on either Claude Code or Mozaik-native OpenAI. Pick one (or set up both — --llm switches between them per run):
  • Claude Code CLI for --llm claude (the default). baro shells out to claude --print and bills against your Claude Max subscription. See claude.com/code.
  • OPENAI_API_KEY for --llm openai. baro calls the OpenAI Responses API directly through Mozaik's native runner. Get a key at platform.openai.com. Export it before running or enter it interactively on the welcome screen.
• gh (optional) if you want baro to auto-open the pull request when a run finishes. Without it, baro pushes the branch and stops.

See LLM providers for the full comparison — what each path does under the hood, model defaults per phase, and when to pick which.

Install

npm install -g baro-ai

Verify:

baro --version

You should get baro 0.38.x or newer.

Verify your environment

Run the built-in self-diagnostic:

baro --doctor

You'll get a pass/fail report for each check baro depends on. Every check should print ✓. If any of them fails, the report tells you specifically what's wrong and where to look — see Troubleshooting for the longer walkthroughs.

Your first run

Once baro --doctor is fully green, give baro a goal:

cd path/to/your/repo
baro "Add a CONTRIBUTING.md at the repo root"

See Quickstart for the end-to-end shape of a run.