Skip to content

Back to the catalog

Kodo
github.comrepo

Kodo

Kodo is an open-source orchestrator (uv-installable as kodo-agent) that directs Claude Code agents through multi-cycle work sessions with independent verification, running overnight on a Claude Code Max subscription. A Gemini Flash (or Claude API) orchestrator delegates to a team of specialized agents - architect, worker_smart, worker_fast, tester, tester_browser - configurable via team.json, and the project reports a 24% improvement on a 100-task GitHub-issue benchmark from adding this orchestration layer over a single agent run.

TL;DR CLI tool that orchestrates teams of Claude Code (and Cursor/Codex/Gemini) agents through verified, multi-cycle autonomous coding runs.
Document

What it claims

Kodo adds an orchestration layer over coding agents so a goal set at night yields tested, reviewed code by morning, running workers on a Claude Code Max subscription while an orchestrator delegates. The headline number the summary cites gets a critical qualifier here: the 24% gain was a 100-task head-to-head using the same underlying model (Cursor composer-1.5) — same model, same prompt, same conditions — isolating orchestration as the sole variable, not comparing a strong model against a weak one.

How it works

Beyond the orchestrator→team structure the summary describes, the page documents a verification loop as the core mechanism: workers done(), then tester, tester_browser, and architect each independently sign off, and any rejection sends work back. The showcased blackopt run went 9 rejection rounds (resource leak, class-variable contamination, state mutation, crossover edge cases) before acceptance — the architect verifier caught bugs the worker was blind to.

The page also argues for an API orchestrator over a CLI one: CLI coding tools (Claude Code, Cursor, Codex) try to write code themselves and micromanage, whereas a plain API model stays in a delegation-only lane.

Two modes the summary omits entirely:

  • kodo test — exercises the software as a real user (install, every feature/flag, edge cases), writes failing regression tests, then fixes. Tracks coverage in .kodo/test-coverage.md.
  • kodo --improve — senior-dev code review for simplification/usability/architecture, auto-fixes safe issues, flags ambiguous ones.

How to use it

uv tool install kodo-agent
uv tool install 'kodo-agent[benchmark]'   # adds kodo-bench SWE-bench harness

Needs uv and at least one backend; Claude Code plus one fast backend (Cursor/Codex/Gemini CLI) recommended. Set GOOGLE_API_KEY (Gemini orchestrator, "fast and cheap") or ANTHROPIC_API_KEY.

kodo --goal 'Build X' --team full --exchanges 50 --cycles 10 ./my-project
kodo --resume 20260218_205503
kodo --fix-from <RUN_ID>

Flags worth knowing: --effort low|standard|high|max, --auto-refine and --skip-intake for unattended runs, --no-auto-commit, --json. Cost is split into Virtual (subscription-covered, workers) and API (real spend, orchestrator).

Limits

The page's own warning: agents run in bypassPermissions mode with full permissions — they primarily work in the project dir but can access any file on your system (install deps, edit configs). It explicitly says to have a git commit or backup before launching. Browser/Docker/VPS tasks that agents can't self-provision surface under a "Blocked Workflows" report section rather than being handled.

Organisations named here

  • Cursor
  • Anthropic
  • Google
  • GitHub
  • Claude Code

Technologies named here

  • Kodo
  • Cursor composer-1.5
  • uv
  • Gemini Flash
  • kodo-bench
  • Claude
  • Opus
  • Claude Code
  • Cursor
  • Sonnet
  • Codex
  • Gemini CLI
  • Kimi
  • Kiro
  • kodo.viewer
  • Python

Techniques named here

  • Multi-agent orchestration cycles
  • Iterative independent verification rounds
  • Coverage tracking for repeated test runs
  • Custom team configuration via team.json
  • Auto-commit after stages