# no-mistakes

> A local git proxy that runs an AI-driven validation pipeline (review, test, docs, lint) before forwarding your branch and opening a clean PR automatically.

**no-mistakes** is an open-source CLI tool built in Go by Kun Chen that acts as a local git proxy in front of your real remote. Instead of pushing directly to `origin`, you push to `no-mistakes`, which spins up a disposable worktree, runs an AI-driven validation pipeline, and only forwards the branch after every check passes — then opens a clean PR automatically. It is available under the MIT License and supports macOS, Linux, and Windows.

## What It Is

no-mistakes addresses a shift in the AI-assisted development workflow: AI agents can generate thousands of lines of code quickly, but the bottleneck has moved to reviewing and validating that output. The tool moves quality infrastructure — rebase, AI code review, test execution, documentation updates, linting, and CI watching — into a local gate that runs before the branch ever reaches the remote. The result is a clean PR raised without manual intervention.

## How the Gate Model Works

When you run `git push no-mistakes`, the tool:

- Creates a **disposable worktree** so your working directory is never disrupted
- Runs the pipeline in sequence: **review → test → docs → lint → push → PR → CI**
- Applies **safe, mechanical fixes** automatically (auto-fix findings)
- **Escalates** anything that touches intent to the human for approval, fix, or skip
- Forwards the branch to the configured push target only when every check is green
- Opens the PR body automatically — no hand-written description needed

## Three Entry Points

The same pipeline is reachable from three different surfaces depending on how you're working:

- **`git push no-mistakes`** — the explicit Git path; push a committed branch to the gate remote
- **`no-mistakes`** (TUI) — run after making changes (no commit required); a wizard handles branch creation, commit, and push, then attaches to the run; `-y` flag automates the whole flow
- **`/no-mistakes`** (agent skill) — installed for Claude Code and other agents via `no-mistakes init`; lets a coding agent do a task and gate it, or gate existing committed work headlessly

## Agent Compatibility

no-mistakes is designed to be **agent-agnostic**. The README lists explicit support for `claude`, `codex`, `rovodev`, `opencode`, `pi`, `copilot`, and any ACP-compatible target via `acpx`. The `/no-mistakes` skill drives `no-mistakes axi`, a non-interactive interface to the same approval flow, so agents can run the full pipeline without a human at the keyboard until a judgment call is needed.

## Update: v1.31.2

The latest release is **v1.31.2**, published on 2026-06-27. The repository was created in April 2026 and has seen rapid iteration, with the last push recorded on 2026-07-01. The project has accumulated over 4,500 GitHub stars and 259 forks, signaling strong early traction in the AI-assisted development tooling space. Active development is ongoing with 54 open issues tracked at the time of writing.

## Features
- Local git proxy that intercepts pushes before they reach origin
- AI-driven code review catches bugs and tech debt early
- Automated regression and new test execution
- Documentation kept up to date automatically
- Linting and formatting applied before push
- Automatic PR creation with CI watching
- Disposable worktree keeps your working directory undisturbed
- Auto-fix for safe mechanical findings; human escalation for intent-touching changes
- TUI for interactive approval flow
- Agent skill (/no-mistakes) for headless pipeline execution
- Support for fork contributions via --fork-url flag
- Agent-agnostic: works with claude, codex, rovodev, opencode, pi, copilot, acpx

## Integrations
Claude Code, OpenAI Codex, Rovodev, opencode, GitHub, GitHub Actions CI, ACP-compatible agents (acpx), Git

## Platforms
WINDOWS, MACOS, LINUX, API, CLI

## Pricing
Open Source

## Version
v1.31.2

## Links
- Website: https://kunchenguid.github.io/no-mistakes/
- Documentation: https://kunchenguid.github.io/no-mistakes/start-here/quick-start/
- Repository: https://github.com/kunchenguid/no-mistakes
- EveryDev.ai: https://www.everydev.ai/tools/no-mistakes