Introduction
baro is an autonomous software factory — it compiles a goal into a contract, builds it with parallel agents, and blocks every merge behind machine gates.
baro takes a goal in your repo and comes back with a verified pull request. It compiles the goal into a machine-checkable contract, splits it into a DAG of stories, builds them in parallel across isolated git worktrees, and blocks every merge behind fail-closed gates — declared tests, build, an evidence critic, write-surface ownership. You review a PR the gates already accepted.
Built on mozaik: every part of a run — board, planner, architect, critic, story agents — is a participant on one shared event bus.
Get started
Installation
Install from npm, set up a backend (Claude CLI, Codex CLI, or any OpenAI-compatible endpoint), verify with baro --doctor.
Quickstart
Run your first goal end-to-end and open a PR.
Running baro
The CLI reference — goal files, background runs, watch/logs/runs/stop, resume vs continue.
LLM providers
claude | codex | openai | opencode | pi | hybrid | jigjoy — per-phase routing, model defaults, tier maps.
Understand it
How it works
Two processes, the mozaik bus, bounded contexts, and the anti-corruption layer in front of every model.
Verification & gates
The contract, the gate registry, the evidence critic, and the rules every gate obeys.
Execution modes
focused / sequential / parallel — decided before the first agent spawns, enforced in code.
The TUI
A terminal workbench for the fleet — live signals, the plan graph, mid-run chat with any agent.
Run it anywhere
baro connect
Pair your machine as a runner — fire goals from the dashboard, a teammate, or a GitHub issue, on your own subscription.
baro's cloud
No machine or subscription? Isolated sandboxes on our infrastructure, prepaid credits.
Troubleshooting
baro --doctor and the diagnostic flow for failed runs.
Resources
baro on GitHub
Source, issues, releases — and the copy-paste prompt for driving baro with Claude Code.
baro-ai on npm
Published CLI. npm install -g baro-ai.
Engineering blog
The story of why baro exists and how it works.
License
baro is released under the MIT License by the JigJoy team.