no-mistakes is a Go-based developer tool that implements a local git proxy to intercept and validate code before it reaches a remote repository. The project's tagline, "git push no-mistakes," reflects its core function: users push to a local gate instead of directly to origin, triggering an automated validation pipeline that runs in an isolated worktree without disrupting the developer's current work. The tool is cross-platform, supporting macOS, Linux, and Windows.
The validation pipeline operates as a series of checks that either pass independently or surface findings for developer action. The system distinguishes between safe, mechanical fixes that can be applied automatically and changes that require human judgment. Nothing is forwarded to the configured push target until all checks pass. This design keeps humans in control while automating routine corrections. Once validation completes successfully, the tool automatically opens a pull request, eliminating manual git push and PR body composition steps.
The tool supports multiple AI coding agents including Claude, Codex, Rovodev, OpenCode, Pi, Copilot, and custom targets via acpx, with ordered fallbacks if a primary agent is unavailable. This agent-agnostic approach allows developers to choose their preferred AI assistant. For developers using coding agents, no-mistakes provides a /no-mistakes skill that agents can invoke to gate their own work, running the pipeline and applying safe fixes while escalating judgment calls to the human developer.
Three entry points accommodate different workflows. The explicit git path uses git push no-mistakes to trigger the gate. A TUI mode runs after making changes, walking users through branch creation, committing, and pushing through the gate. The agent skill allows developers to tell their coding agent to perform a task and gate it with /no-mistakes, or to gate existing committed work.
The project overlaps contributors with gsd-build/get-shit-done, bytedance/deer-flow, and microsoft/vscode, suggesting integration with broader development ecosystems.
The repository includes development infrastructure with a Makefile providing various build targets. Documentation is hosted at kunchenguid.github.io/no-mistakes, with installation guides, quick start instructions, and comprehensive usage documentation. The project maintains active community engagement through Discord and X social media channels.
