What is code-oz, in 2 minutes?

[omerakben]

What is code-oz?

code-oz is a standalone terminal CLI that runs AI coding agents through a real software delivery lifecycle. It coordinates role-specialized agents (BA, Lead, Builder, Verifier, Reviewer, Scientist) over a hybrid phase-graph spine with hard gates between phases, file-based state, and cross-family adversarial review.

The 2-minute version

• Greenfield flow: DEFINE → PLAN → BUILD → VERIFY → REVIEW → SHIP. Each phase has a canonical artifact (SPEC.md, PLAN.md, BUILD_REPORT.md, VERIFY.md, REVIEW.md, SHIP.md) and a file-based gate (GATE_<PHASE>_PASSED.json with sha256 binding to the artifact).
• Brownfield flow: AUDIT → PLAN → BUILD → VERIFY → REVIEW → SHIP. AUDIT runtime is M17 (next milestone after v0.20.0-alpha.0).
• Cross-family REVIEW: REVIEW provider family MUST differ from BUILD provider family. If you wrote BUILD with Claude, REVIEW runs on Codex (or vice versa). Catches the bugs single-model loops miss.
• Worktree-per-run isolation: every run gets its own git worktree. No collisions, no half-applied patches.
• Run-level cost budgets: budgets.global.maxTokensEstimate, maxProviderCalls, maxTurns, maxWallTimeMinutes enforced by assertWithinBudget(). Hard kills at 1.0x; soft warnings at 0.75x.
• Debate runtime: requestDebate() primitive (M10) + auto-debate scheduler (M15) for score grey-zones and panel disagreement.
• Runs on YOUR CLI auth. No API keys for Claude/Codex/Gemini — the providers read your CLI OAuth tokens from disk.

Install (three channels, same SHA-pinned binary)

# curl | sh
curl -fsSL https://github.com/omerakben/code-oz/releases/download/v0.20.0-alpha.0/install.sh \
  | sh -s -- --version v0.20.0-alpha.0

# npm
npm install -g @tuel/code-oz

# Homebrew
brew tap omerakben/code-oz
brew install omerakben/code-oz/code-oz

Try the demo

git clone https://github.com/omerakben/code-oz.git
cd code-oz && bun install
bun run demo:todo-cli                # balanced effort
bun run demo:todo-cli --effort beast # full headroom (multiplier 6.0)

Where the deep dive lives

• docs/ABOUT.md — milestone inventory, product thesis, influence library, architecture locks
• docs/design/ROADMAP.md — milestone plan beyond v0.20
• CLAUDE.md — the 23 non-negotiable rules + cross-model peer review discipline
• docs/product/AI_SOFTWARE_COMPANY_THESIS.md — product north star

Status

v0.20.0-alpha.0 — first release with official install channels. 3366 tests pass offline. Live xAI integration gated behind opt-in env flags. The MIT-licensed CLI runs on your own Claude/Codex CLI subscriptions; xAI uses an API key today.

Ask anything below.