### Install no-mistakes

Source: https://kunchenguid.github.io/no-mistakes/start-here/quick-start

Installs the binary and restarts the background daemon using a shell script.

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

--------------------------------

### Install on Windows

Source: https://kunchenguid.github.io/no-mistakes/start-here/installation

Uses PowerShell to download and execute the installation script.

```powershell
irm https://raw.githubusercontent.com/kunchenguid/no-mistakes/main/docs/install.ps1 | iex
```

--------------------------------

### Run validation commands

Source: https://kunchenguid.github.io/no-mistakes/reference/cli

Examples of starting a validation run with various configurations, including intent, skipping steps, and auto-resolution.

```bash
no-mistakes axi run --intent "the user's goal"
no-mistakes axi run --intent "the user's goal" --skip test,lint
no-mistakes axi run --intent "the user's goal" --yes
```

--------------------------------

### Start the daemon manually

Source: https://kunchenguid.github.io/no-mistakes/guides/troubleshooting

Installs or refreshes the managed service and starts the daemon.

```bash
no-mistakes daemon start
```

--------------------------------

### no-mistakes daemon start

Source: https://kunchenguid.github.io/no-mistakes/reference/cli

Starts the daemon, attempting to install or refresh a managed service (systemd/launchd) if possible, or falling back to a detached process.

```APIDOC
## no-mistakes daemon start

### Description
Starts the daemon process. It prefers managed service paths and falls back to a detached daemon if necessary. If already running, it refreshes the service definition if stale.

### Usage
`no-mistakes daemon start`
```

--------------------------------

### Initialization output example

Source: https://kunchenguid.github.io/no-mistakes/start-here/quick-start

Displays the expected output after successfully initializing a gate.

```text
$ 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>
```

--------------------------------

### Build and Install from Source

Source: https://kunchenguid.github.io/no-mistakes/start-here/installation

Clones the repository and builds the binary using make, which allows for embedding telemetry configuration.

```bash
git clone git@github.com:kunchenguid/no-mistakes.git
cd no-mistakes
make build
make install
```

--------------------------------

### Monitor the pipeline

Source: https://kunchenguid.github.io/no-mistakes/start-here/quick-start

Attach to an active run or initiate the setup wizard using the CLI.

```bash
no-mistakes
```

--------------------------------

### Install CLI via Go

Source: https://kunchenguid.github.io/no-mistakes/start-here/installation

Installs the CLI binary without embedded telemetry IDs by default.

```bash
go install github.com/kunchenguid/no-mistakes/cmd/no-mistakes@latest
```

--------------------------------

### Install and Configure Azure CLI for Azure DevOps

Source: https://kunchenguid.github.io/no-mistakes/guides/provider-integration

Install the Azure CLI and the devops extension, then authenticate using a Personal Access Token.

```bash
# macOS
brew install azure-cli


# Linux / Windows
# see https://learn.microsoft.com/en-us/cli/azure/install-azure-cli


az extension add --name azure-devops


# Authenticate with a Personal Access Token (Code: Read & Write, Pull Request
# Threads, Build: Read). Either run `az devops login` and paste the PAT, or
# export it for non-interactive use:
export AZURE_DEVOPS_EXT_PAT=your-pat
```

--------------------------------

### Install and Authenticate GitLab CLI

Source: https://kunchenguid.github.io/no-mistakes/guides/provider-integration

Commands to install the GitLab CLI on macOS or Linux and initiate the authentication process.

```bash
# macOS
brew install glab


# Linux
# see https://gitlab.com/gitlab-org/cli


glab auth login
```

--------------------------------

### no-mistakes

Source: https://kunchenguid.github.io/no-mistakes/reference/cli

Attaches to an active pipeline run or initiates a setup wizard to create a new run.

```APIDOC
## no-mistakes

### Description
Attaches to the active pipeline run for the current branch. If no run exists, it starts a setup wizard to create a branch, commit changes, and push through the gate.

### Parameters
#### Flags
- **-y, --yes** (bool) - Optional - Run setup wizard and accept defaults automatically.
- **--skip** (string) - Optional - Comma-separated pipeline steps to skip for a new run (e.g., intent, rebase, review, test, document, lint, push, pr, ci).
```

--------------------------------

### Install and Authenticate GitHub CLI

Source: https://kunchenguid.github.io/no-mistakes/guides/provider-integration

Commands to install the GitHub CLI on macOS and authenticate the session.

```bash
# macOS
brew install gh


# Linux
# see https://github.com/cli/cli/blob/trunk/docs/install_linux.md


gh auth login
```

--------------------------------

### Example of matched path instructions

Source: https://kunchenguid.github.io/no-mistakes/reference/repo-config

Representation of how matched files are associated with specific instructions.

```text
path: docs/**
matched files: docs/notes.md
instructions:
Prose changes only. Do not request test coverage.
```

--------------------------------

### Execute no-mistakes CLI commands

Source: https://kunchenguid.github.io/no-mistakes/reference/cli

Run the base command to attach to a pipeline or initiate the setup wizard, optionally skipping specific pipeline steps.

```bash
no-mistakes
no-mistakes --skip test,lint
```

--------------------------------

### Define agent_config settings

Source: https://kunchenguid.github.io/no-mistakes/reference/global-config

Example configuration defining model and effort levels for various agents.

```yaml
agent_config:
  codex:
    model: gpt-5.4
    effort: low
  claude:
    model: sonnet
    effort: high
  opencode:
    model: openai/gpt-5
  cursor:
    model: gpt-5
```

--------------------------------

### Respond to approval gates

Source: https://kunchenguid.github.io/no-mistakes/reference/cli

Examples of using the axi respond command with various actions to manage pipeline gates.

```bash
no-mistakes axi respond --action approve
no-mistakes axi respond --action fix --findings F1,F2 --instructions "optional guidance"
no-mistakes axi respond --action fix --add-finding '{"description":"...","action":"auto-fix"}'
no-mistakes axi respond --action skip
```

--------------------------------

### Configure agent_args_override in YAML

Source: https://kunchenguid.github.io/no-mistakes/reference/global-config

Example configuration showing how to pass custom flags to various agents like Claude, Codex, Grok, Rovodev, and Pi.

```yaml
agent_args_override:
  claude:
    - --model
    - sonnet
    - --permission-mode
    - acceptEdits
  codex:
    - -m
    - gpt-5.4
    - -c
    - service_tier="priority"
    - -c
    - model_reasoning_effort="low"
  grok:
    - --reasoning-effort
    - high
  rovodev:
    - --profile
    - work
  pi:
    - --provider
    - google
```

--------------------------------

### Restart the no-mistakes daemon

Source: https://kunchenguid.github.io/no-mistakes/reference/cli

Performs a stop followed by a start operation. This command is effective regardless of the current daemon state.

```bash
no-mistakes daemon restart
no-mistakes daemon restart --force
```

--------------------------------

### Execute no-mistakes via coding agent

Source: https://kunchenguid.github.io/no-mistakes/start-here/quick-start

Run tasks or validate existing commits directly through a coding agent using the installed skill.

```bash
/no-mistakes add a --json flag to the status command
```

```bash
/no-mistakes
```

--------------------------------

### Configure forge_profiles

Source: https://kunchenguid.github.io/no-mistakes/reference/global-config

Define machine-local routing for repositories using different GitHub or GitLab identities. Paths must be absolute or start with ~/, and host keys are case-insensitive.

```yaml
forge_profiles:
  github-personal:
    gh_config_dir: ~/.config/gh-personal
  github-work:
    gh_config_dir: /Users/you/.config/gh-work
  gitlab-work:
    glab_config_dir: ~/.config/glab-work
    expected_login: team-bot
```

--------------------------------

### Initialize a repository

Source: https://kunchenguid.github.io/no-mistakes/start-here/quick-start

Sets up the local gate and hooks for a git repository.

```bash
no-mistakes init
```

--------------------------------

### Rerun the pipeline

Source: https://kunchenguid.github.io/no-mistakes/reference/cli

Starts a new pipeline run from the current branch, optionally overriding the intent.

```bash
no-mistakes rerun
no-mistakes rerun --intent "the revised user goal"
```

--------------------------------

### Configure ci.revalidate_repairs

Source: https://kunchenguid.github.io/no-mistakes/reference/repo-config

Example configuration for enabling revalidation of CI repairs in the project configuration file.

```yaml
ci:
  revalidate_repairs: true
```

--------------------------------

### Initialize no-mistakes

Source: https://kunchenguid.github.io/no-mistakes/reference/cli

Commands to initialize or refresh the gate for the current repository. Requires an origin remote to be configured.

```bash
no-mistakes init
no-mistakes init --fork-url git@github.com:you/my-repo.git
no-mistakes init --worktree-root ~/work/my-repo-runs
```

--------------------------------

### Initialize Fork Routing

Source: https://kunchenguid.github.io/no-mistakes/guides/provider-integration

Configure the repository remotes to support pushing to a fork while opening PRs against the parent repository.

```bash
git remote set-url origin git@github.com:parent-owner/repo.git
no-mistakes init --fork-url git@github.com:your-user/repo.git
```

--------------------------------

### Configure GitHub Enterprise Host

Source: https://kunchenguid.github.io/no-mistakes/guides/troubleshooting

Run this command to authenticate with a self-hosted GitHub Enterprise instance when detection fails.

```bash
gh auth login --hostname your-ghe.example.com
```

--------------------------------

### Configure path-specific review instructions

Source: https://kunchenguid.github.io/no-mistakes/reference/repo-config

Define rules in .no-mistakes.yaml to apply specific instructions to files matching glob patterns.

```yaml
review:
  path_instructions:
    - path: "internal/scm/**"
      instructions: |
        Any URL or error string that can carry credentials must go through internal/safeurl.
    - path: "docs/**"
      instructions: |
        Prose changes only. Do not request test coverage.
```

--------------------------------

### Daemon Initialization and Execution Commands

Source: https://kunchenguid.github.io/no-mistakes/concepts/daemon

Commands that ensure the daemon is running before executing specific tasks.

```bash
no-mistakes
no-mistakes init
no-mistakes attach
no-mistakes rerun
no-mistakes axi run
no-mistakes axi respond
```

--------------------------------

### Update the no-mistakes binary

Source: https://kunchenguid.github.io/no-mistakes/reference/cli

Commands to update the installed binary, including options for beta releases, non-interactive confirmation, and forced updates.

```bash
no-mistakes update
no-mistakes update --beta
no-mistakes update -y
no-mistakes update --force
```

--------------------------------

### Findings panel structure

Source: https://kunchenguid.github.io/no-mistakes/guides/tui

Example of the findings panel output when a step pauses for approval, including risk levels and finding details.

```text
  Risk: MEDIUM
  Potential null pointer in error path


  > [x] E  src/handler.go:42
          Missing nil check before dereferencing resp.Body
         > keep the existing retry behavior
    [x] I  [user]
          Also update the CLI help text for this new flag
         > mention the env var in the docs too
    [x] W  src/handler.go:78
          Error string should not be capitalized
    [ ] I  src/handler.go:95
          Consider extracting this into a helper function
```

--------------------------------

### Configure GitLab Host

Source: https://kunchenguid.github.io/no-mistakes/guides/troubleshooting

Run this command to authenticate with a self-hosted GitLab instance when detection fails.

```bash
glab auth login --hostname your-gitlab.example.com
```

--------------------------------

### no-mistakes axi run

Source: https://kunchenguid.github.io/no-mistakes/reference/cli

Starts or reattaches to a validation run for the current branch. This command blocks until a gate, decision point, or final outcome is reached.

```APIDOC
## no-mistakes axi run

### Description
Starts or reattaches to validation for the current branch. It blocks execution until the first approval gate, CI-ready decision point, or final outcome is reached.

### Parameters
#### Flags
- **--intent** (string) - Required - The user's goal or request for the validation run.
- **-y, --yes** (bool) - Optional - Auto-resolve every gate until a decision point or outcome.
- **--skip** (string) - Optional - Comma-separated list of pipeline steps to skip.

### Request Example
no-mistakes axi run --intent "the user's goal"
```

--------------------------------

### Initialize a fork repository

Source: https://kunchenguid.github.io/no-mistakes/start-here/quick-start

Initializes a gate for GitHub fork contributions by specifying the fork URL.

```bash
no-mistakes init --fork-url git@github.com:you/my-repo.git
```

--------------------------------

### Configure Gitea Login

Source: https://kunchenguid.github.io/no-mistakes/guides/troubleshooting

Add a login configuration for a self-hosted Gitea instance to enable detection.

```bash
tea logins add --url https://your-gitea.example.com --token <token> --name <name>
```

--------------------------------

### Configure Bitbucket Cloud Environment Variables

Source: https://kunchenguid.github.io/no-mistakes/guides/provider-integration

Set the required email and API token environment variables to enable Bitbucket Cloud integration.

```bash
export NO_MISTAKES_BITBUCKET_EMAIL=you@example.com
export NO_MISTAKES_BITBUCKET_API_TOKEN=your-api-token


# Optional: override the API base URL
export NO_MISTAKES_BITBUCKET_API_BASE_URL=https://api.bitbucket.org/2.0
```

--------------------------------

### Check prerequisites

Source: https://kunchenguid.github.io/no-mistakes/start-here/quick-start

Verifies that the environment is correctly configured to run validation gates.

```bash
no-mistakes doctor
```

--------------------------------

### Uninstall no-mistakes

Source: https://kunchenguid.github.io/no-mistakes/start-here/installation

Stops the daemon and removes the binary and state directories.

```bash
no-mistakes daemon stop
rm -f ~/.local/bin/no-mistakes /usr/local/bin/no-mistakes
rm -rf ~/.no-mistakes
```

--------------------------------

### Verify Gitea Login

Source: https://kunchenguid.github.io/no-mistakes/guides/provider-integration

Lists all configured Gitea logins to verify successful authentication.

```bash
tea logins list
```

--------------------------------

### Monitor daemon logs

Source: https://kunchenguid.github.io/no-mistakes/guides/troubleshooting

Follow the daemon log file to debug startup or runtime issues.

```bash
tail -f ~/.no-mistakes/logs/daemon.log
```

--------------------------------

### Verify the no-mistakes remote

Source: https://kunchenguid.github.io/no-mistakes/guides/troubleshooting

Use this command to confirm the remote is correctly configured in your repository.

```bash
git remote -v | grep no-mistakes
```

--------------------------------

### Inspect agent performance and run details

Source: https://kunchenguid.github.io/no-mistakes/reference/cli

Provides detailed performance metrics for agents or specific pipeline runs.

```bash
no-mistakes stats --agents
no-mistakes stats --run <id>
```

--------------------------------

### Configure Gitea Login

Source: https://kunchenguid.github.io/no-mistakes/guides/provider-integration

Adds a new Gitea instance login to the tea CLI configuration.

```bash
tea logins add --url https://your-gitea.example.com --token your-token --name your-instance
```

--------------------------------

### Show historical usage stats

Source: https://kunchenguid.github.io/no-mistakes/reference/cli

Displays aggregate usage statistics across all repositories.

```bash
no-mistakes stats
```

--------------------------------

### Inspect gate hooks

Source: https://kunchenguid.github.io/no-mistakes/guides/troubleshooting

Check the status of the gate and verify that the pre-receive and post-receive hooks are present and executable.

```bash
no-mistakes status
# gate path is shown in the output


ls -la <gate-path>/hooks/pre-receive <gate-path>/hooks/post-receive
```

--------------------------------

### Execute axi sync commands

Source: https://kunchenguid.github.io/no-mistakes/reference/cli

Various modes for checking, applying, or recovering branch synchronization states.

```bash
no-mistakes axi sync --check
no-mistakes axi sync
no-mistakes axi sync --recover
no-mistakes axi sync --recover --keep-local
```

--------------------------------

### Execute AXI

Source: https://kunchenguid.github.io/no-mistakes/reference/cli

Run the base AXI command to display status, active runs, and guidance.

```bash
no-mistakes axi
```