Expand description
magi — a blind multi-agent implementation competition.
One task, several agents, and a graph that decides which implementation survives without a human reading the diff:
- implement — N agents solve the same task in isolated git worktrees, unaware of each other.
- judge — M judges rank the candidates blind: labels
A/B/C, a per-judge presentation order, attribution trailers stripped at write time by acommit-msghook and again at presentation time. - deliberate — if the first choices disagree, the judges argue, with magi as the facilitator. A facilitator made of code cannot leak an author.
- vote — final votes are collected one-to-one and privately, so nobody can drift toward a visible majority.
- review — the winner enters a bounded review + real-machine verification loop with a fixer that may reject a finding with an argument.
- gate — configured commands must pass before anything merges.
Everything is recorded, so the by-products are real numbers: per-agent win
rates, per-reviewer precision, and how often execution caught what static
review missed. See stats.
Modules§
- agent
- Driving agent CLIs.
- ask
- Questions: what an agent does when the next decision is the owner’s.
- blind
- Blindness: label assignment, attribution stripping, and leak detection.
- chat
- The browser interview:
magi planfor somebody holding a phone. - config
- Run configuration: the agent roster, the shape of the graph, and the blindness / verification policy.
- daemon
- The unattended loop: take the next task, run the graph, record what happened, take the next one.
- git
- Git plumbing.
- graph
- The competition graph.
- land
- Landing the winner: watch the pull request, fix what it complains about, and merge it.
- md
- GFM markdown, parsed into a serializable node tree instead of HTML.
- plan
magi plan: the interview that turns an idea into a task file worth competing.- prompt
- Prompt construction.
- queue
- The task queue: what magi should do next, and who asked for it.
- report
- Terminal rendering.
- repos
- Local repository discovery for the plan surface’s repository picker.
- rng
- A seeded PRNG, so that label assignment and session ids are reproducible from a run id.
- run
- Run state: what happened, where it is stored, and how a run is resumed.
- stats
- Aggregate statistics over every recorded run.
- tui
- The observation deck.
- updater
- Self-update, via
kaishin. - verdict
- Structured answers extracted from free-form agent output.
- web
- The web UI: magi’s queue and run history, readable from a phone.