zeroshot
Zeroshot is an open-source CLI that runs autonomous multi-agent AI workflows to write, review, test, and iterate on code changes until they pass validation. It orchestrates separate planner, implementer, and validator agents to reduce hallucination and improve correctness in AI-generated code.
Key facts
Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.
| Field | Value |
|---|---|
| Repository | the-open-engine/zeroshot |
| Owner | the-open-engine |
| Primary language | JavaScript |
| License | MIT — OSI-approved |
| Stars | 1.6k |
| Forks | 140 |
| Open issues | 52 |
| Latest release | v6.2.0 (2026-06-27) |
| Last updated | 2026-07-06 |
| Source | https://github.com/the-open-engine/zeroshot |
What zeroshot is
A Node.js-based agent orchestration framework that shells out to provider CLIs (Claude Code, Codex, Gemini, OpenCode) and runs isolated validation loops with crash-safe SQLite persistence. Supports GitHub/GitLab/Jira/Azure DevOps issue backends and configurable quality gates; no built-in validation tooling—gates are user-defined or external commands.
Get the zeroshot source
Clone the repository and explore it locally.
git clone https://github.com/the-open-engine/zeroshot.gitcd zeroshot# follow the project's README for install & configurationNeed it deployed, integrated, or customized instead? DEV.co ships production installs.
Best use cases
Implementation considerations
- Requires at least one provider CLI installed and authenticated (Claude Code, Codex, Gemini, or OpenCode); no built-in language model—all inference is delegated to external services.
- Isolation modes (none, git worktree, Docker) must be chosen per task; Docker isolation adds complexity but is needed for sensitive or high-concurrency workflows.
- Quality gates and validators are user-defined; you must script or wire external commands (repo-quality, CI scripts, linters) into the gate configuration; Zeroshot orchestrates but does not provide these tools.
- Crash recovery relies on SQLite persistence in `~/.zeroshot/`; ensure write permissions and adequate disk space for large workflows or multi-day runs.
- Node 18+ required; npm install is global (`-g`); ensure PATH and npm prefix are correctly configured in CI or container environments to avoid agent startup failures.
When to avoid it — and what to weigh
- Task requires exploration or discovery — If the acceptance criteria are undefined ('make the app faster', 'improve the codebase'), agents will loop without clear exit conditions. Use for well-scoped, measurable tasks only.
- You need native Windows support — Platform support is Linux and macOS only; Windows native and WSL are deferred. Teams requiring Windows must wait for hardening or use Docker workarounds.
- Validation tooling does not exist or is incomplete — Zeroshot does not provide built-in test runners or linters. You must have existing CI/test infrastructure that agents can invoke; otherwise, blind validation cannot work.
- Real-time human feedback or live code review is essential — Zeroshot is designed for offline, autonomous loops. If your workflow requires synchronous human input between iterations, a chat-based assistant is more appropriate.
License & commercial use
MIT License (OSI-approved, permissive). Permits commercial use, modification, and distribution with minimal restrictions; requires only license and copyright notice retention.
MIT is a permissive open-source license that explicitly allows commercial use without restrictions or royalty obligations. No commercial license or proprietary terms are documented. Use is permitted in closed-source products and commercial services as long as the MIT license text and attribution are retained. Recommended to review the LICENSE file in the repository for any additional terms, but MIT itself imposes no commercial use barriers.
DEV.co evaluation signals
Editorial assessment — not user reviews. Directional, with an explicit confidence level.
| Signal | Assessment |
|---|---|
| Maintenance | Active |
| Documentation | Adequate |
| License clarity | Clear |
| Deployment complexity | Moderate |
| DEV.co fit | Good |
| Assessment confidence | Medium |
Code execution risk: agents run arbitrary shell commands in isolated environments (none/worktree/Docker); ensure validation scripts are audited and untrusted input is rejected at the task level. Authentication: provider CLIs and GitHub/GitLab credentials are stored locally; protect `~/.zeroshot/` and token directories. Docker mode adds container escape risk and supply-chain risk if base images are not pinned. No security policy, vulnerability disclosure process, or hardening recommendations are documented in the provided excerpt.
Alternatives to consider
GitHub Copilot for pull requests / OpenAI GPT-4 Code Interpreter
Chat-based or single-agent workflows; simpler setup but no blind validation loop or isolated agents; faster for exploration but higher hallucination risk for critical code.
Devin (Cognition) or similar AI engineer platforms
Closed-source, hosted agent platforms; no self-hosting, no control over isolation or validation logic; but mature, well-supported, and require less setup for small teams.
Custom agent orchestration (LangChain, AutoGPT, crews, etc.)
Full control over agent logic, models, and validation; higher development cost and maintenance burden; suitable for teams with strong AI/ML and DevOps expertise who need deep customization.
Build on zeroshot with DEV.co software developers
Start with a local issue: `npm install -g @the-open-engine/zeroshot && zeroshot run '<task>'`. Requires a provider CLI (Claude Code, Codex, Gemini, OpenCode) and existing validation tooling.
Talk to DEV.coRelated open-source tools
Surfaced by semantic similarity across the DEV.co open-source index.
Related on DEV.co
Explore the category and the services that help you build with it.
zeroshot FAQ
Does Zeroshot come with built-in test runners or linters?
What happens if an agent fails or the process crashes?
Can I use Zeroshot in CI/CD pipelines?
Is Windows supported?
Work with a software development agency
Adopting zeroshot is usually one piece of a larger software development effort. As a software development agency, DEV.co provides software development services and web development expertise — pairing senior software developers and web developers with your team to design, build, and operate ai coding agents software in production.
Ready to automate code with verified agents?
Start with a local issue: `npm install -g @the-open-engine/zeroshot && zeroshot run '<task>'`. Requires a provider CLI (Claude Code, Codex, Gemini, OpenCode) and existing validation tooling.