CLI

The zero CLI is the local entry point: it parses arguments with @bomb.sh/args and renders with @clack/prompts. Inside the repository, run it as aube run zero <command>.

Commands

zero init                   create .agent-zero.yml
zero --version              print the injected CLI version
zero doctor [--json]        inspect the local environment
zero review (--feedback X | --proactive)  inspect without editing
zero fix (--feedback X | --proactive)     validate, edit, and verify (policy permitting)
zero run (--feedback X | --proactive)     run using the configured mode

zero init

Creates .agent-zero.yml with the safe defaults (mode: observe, autofix disabled). See Repository policy.

zero doctor

Inspects the local environment: toolchain, configuration, and provider credentials. --json emits machine-readable output for scripts and CI.

zero review

Inspects without editing — safe on any checkout. Provide the finding to check with --feedback "…", or use --proactive to inspect the working-tree diff without reviewer feedback.

zero fix

Validates, edits, and verifies — when repository policy permits. The full authorization chain in the Safety model applies; without it, fix degrades to reporting the refusal.

zero run

Runs using the mode configured in .agent-zero.yml, so the same invocation is safe (observe) or active (fix) depending on the repository's own policy.

Triggers and interactivity

When neither --feedback nor --proactive is provided in a terminal, the CLI asks for the task interactively. Use explicit flags with --json for scripts and CI.

Exit codes

Exit codes are a contract:

Version

zero --version prints the version injected at build time by @redstardev/unplugin-version-injector into @agent-zero/shared; the CLI displays the same version in its header.