no-mistakes: AI-Driven Git Proxy for Flawless Pull Requests

Introduction

no-mistakes is a powerful local Git proxy designed to elevate your code quality and streamline the pull request process. Instead of pushing directly to your origin remote, you push to no-mistakes. This tool then spins up a disposable worktree, runs an AI-driven validation pipeline, and only forwards your branch to the configured push target after every check passes. It even automates the opening of a clean pull request. This non-blocking approach ensures your local work remains undisturbed while your code undergoes rigorous review, making it easier to maintain a high standard of quality.

Installation

Getting started with no-mistakes is straightforward. For macOS and Linux users, you can install it with a simple curl command:

curl -fsSL https://raw.githubusercontent.com/kunchenguid/no-mistakes/main/docs/install.sh | sh

For detailed instructions on installing no-mistakes on Windows, or building from source, please refer to the official installation guide (opens in a new tab).

Examples

no-mistakes offers flexible ways to integrate into your workflow. Here's a quick start:

First, initialize the gate in your repository:

$ no-mistakes init
  ? Gate initialized

    repo  /Users/you/src/my-repo
    gate  no-mistakes ? /Users/you/.no-mistakes/repos/abc123def456.git
  remote  git@github.com:you/my-repo.git
   skill  /no-mistakes installed for agents at user level

  Push through the gate with:
  git push no-mistakes <branch>

Then, after making changes on your branch, push through the gate:

$ git checkout my-branch

# do some work in the branch...

$ git push no-mistakes
  * Pipeline started

  Run no-mistakes to review.

To review findings and interact with the pipeline, simply run:

$ no-mistakes
# opens the TUI for the active run

There are three primary ways to trigger the no-mistakes gate:

• git push no-mistakes: The explicit Git path. Push a committed branch to the gate remote instead of origin.
• no-mistakes: The TUI. Run it after making changes, even without a commit, and a wizard will guide you through creating a branch, committing, and pushing through the gate.
• /no-mistakes: The agent skill. Tell your coding agent to perform a task and gate it with /no-mistakes <task>, or use bare /no-mistakes to gate existing committed work.

Why Use It

no-mistakes brings several significant advantages to your development workflow:

• Non-blocking: The validation pipeline runs in an isolated worktree, ensuring your current development work is never interrupted.
• Agent-agnostic: It supports various AI coding agents like claude, codex, copilot, and others, making it adaptable to your preferred tools.
• Agent-native: Integrate directly with your coding agents using /no-mistakes to gate tasks or existing work, allowing the pipeline to apply safe fixes and escalate complex issues for your judgment.
• Human stays in charge: You retain full control, with the option to auto-fix findings or review them manually, ensuring that your intent is always respected.
• Clean PRs by default: Automate the entire process from pushing code to opening a pull request, watching CI, and auto-fixing failures, all in one seamless flow.

Links

• GitHub Repository: kunchenguid/no-mistakes (opens in a new tab)
• Official Documentation: no-mistakes Documentation (opens in a new tab)