Frequently Asked Questions

no-mistakes is an AI-powered Git proxy that sits between your local repository and your remote. It runs a comprehensive validation pipeline on your code before pushing it to the remote, ensuring only clean, high-quality code reaches your main repository. The tool automatically opens PRs when all checks pass, eliminating manual push and PR creation steps.

Installation is simple. Just run this command in your terminal:

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

This will install no-mistakes on macOS, Linux, and Windows. For more detailed installation options including Go installation and building from source, check the installation guide.

no-mistakes is compatible with:

• macOS (latest versions)
• Linux (Ubuntu, CentOS, etc.)
• Windows 10/11
• Git (version 2.0 or higher)
• Go (for building from source)

The tool also requires an AI coding agent (like Claude, Copilot, etc.) for the validation pipeline to function properly.

When you push to the no-mistakes remote, it creates a disposable worktree to isolate your changes. The pipeline then runs a series of checks:

1. Code Review - AI analyzes code quality and best practices
2. Testing - Runs your test suite
3. Documentation - Checks for documentation completeness
4. Linting - Enforces code style and consistency
5. Security - Detects potential vulnerabilities
6. Push - Forwards to remote only if all checks pass
7. PR Creation - Opens a clean PR with auto-generated description

Each step either passes automatically or flags issues for your review. Safe mechanical fixes are applied automatically, while anything requiring judgment is escalated to you.

no-mistakes is agent-agnostic and supports:

• Claude - via Claude Code
• GitHub Copilot - native integration
• CodeX - Microsoft's AI coding assistant
• RovoDev - Rovo's development AI
• OpenCode - OpenAI's coding model
• PI - Perplexity's AI assistant
• ACP - via acpx adapter

The tool installs the /no-mistakes skill for Claude Code during initialization. For other agents, you can use the command-line interface or the TUI.

Yes! The pipeline is highly configurable. You can:

• Add custom validation rules
• Configure which checks to run
• Set thresholds for quality metrics
• Define custom auto-fix behaviors
• Integrate with your CI/CD tools

Configuration is done through a YAML file located in your project directory. See the configuration documentation for details.

Integration is seamless:

1. Initialize no-mistakes with no-mistakes init
2. Replace git push origin with git push no-mistakes
3. Use the TUI with no-mistakes for interactive workflow
4. Use /no-mistakes in your coding agent for AI-driven workflow

For GitHub fork contributions, use no-mistakes init --fork-url <your-fork-url>. The tool maintains your existing origin remote while adding the no-mistakes gate.

no-mistakes works with both public and private repositories. The validation pipeline runs locally on your machine, so your code never leaves your environment. The tool only communicates with your remote repository for the final push step, using your existing Git credentials.

Yes! no-mistakes is platform-agnostic. It works with any Git-compatible remote including GitHub, GitLab, Bitbucket, and self-hosted Git solutions. The tool doesn't care about the platform - it only needs access to a Git remote for the final push step.

When the pipeline fails, no-mistakes:

1. Stops the push process
2. Shows detailed findings in the TUI
3. Offers automatic fixes for safe issues
4. Requires your approval for critical changes
5. Provides clear explanations for each failure

You can review each finding, apply fixes, or skip checks as needed. The tool only pushes to your remote when all checks pass.

We welcome contributions and feedback! You can:

• Report bugs on GitHub Issues
• Request features via GitHub Discussions
• Join our Discord community
• Follow us on X (Twitter)

For security issues, please refer to our security policy. We typically respond to issues within 24-48 hours.

no-mistakes is open source under the MIT License, which means:

• Completely free to use
• No hidden costs
• No usage limits
• No paid tiers
• Free to modify and distribute

The only requirement is that you respect the MIT License terms when redistributing. We do accept donations to support ongoing development.