zeroshot
Multi-agent graph harness for Claude Code, Codex and other coding agents. Separate agents review and test the work. Runs locally on your subscription.
What is zeroshot?
Multi-agent graph harness for Claude Code, Codex and other coding agents. Separate agents review and test the work. Runs locally on your subscription.
Overview of zeroshot
What it is
zeroshot is an open-source tool for building your own software factory. It turns a task into a reviewed pull request through a workflow you control. You choose the agents and models, define what must pass, and decide where rejected work goes for repair. The built-in software-change graph follows: implementation → independent review → repair → optional delivery. You can design your own topology, adding security reviewers, test agents, and parallel checks. The agent that writes the code cannot approve its own work; the engine enforces the graph's review gates and retry limits. It runs Claude Code, Codex, or Copilot as the worker and reviewers. The CLI is free and MIT licensed. Run locally, self-host, or use zeroshot Cloud.
Key features
- Built-in
software-changeworkflow: implementation → independent review → repair → optional delivery. - Custom graph topology: add security reviewers, test agents, parallel checks, and define retry paths.
- Each node can use a different model and agent (e.g., worker, acceptance reviewer, code reviewer).
- Engine enforces review gates and retry limits; the writing agent cannot approve its own work.
- Supports local execution, self-hosted Docker target, or zeroshot Cloud.
- CLI and browser UI for managing runs, profiles, and inspecting logs.
- Built-in
auto-researchtemplate for iterative research with scouts, planners, judges, and auditors.
Use cases
- Turn a task into a reviewed pull request with enforced quality gates.
- Add security review, adversarial testing, or end-to-end tests as separate stages.
- Use different models for different roles (e.g., a cheaper model for review, a frontier model for implementation).
- Automate research iterations with independent judges and archival.
- Run locally for prototyping, then switch to self-hosted or cloud for production.
Getting started
bash npm install -g @the-open-engine-company/zeroshot Requires Node.js 18 or newer. After installation, create input.json and runtime.json as described in the repository README, then run: bash zeroshot run --title 'Add JSON status output' --template software-change --input input.json --uniform-runtime-config runtime.json Use zeroshot ui to open the browser UI at http://127.0.0.1:4173/ui/.
License and pricing
MIT license. Open source and free to use.
Based on the project's public README and repository metadata.