CLI Commands
no-mistakes
Attach to the active pipeline run for the current branch when one exists. If none exists, bare no-mistakes can start the setup wizard to create a branch, commit changes, push through the gate, wait for the daemon to register the new run, and then attach. If the push succeeds but no run is registered, that wizard path now exits with an explicit error instead of silently falling through. By default this wizard path is interactive and only runs in a TTY session. In non-interactive contexts, bare no-mistakes falls back to showing the last 5 runs inline unless you pass -y or --yes to run the wizard and accept defaults automatically. When a TTY is available, -y keeps the wizard visible, shows a brief waiting for run… state after push, and auto-advances the default path; without a TTY it falls back to the headless path.
no-mistakes| Flag | Type | Default | Description |
|---|---|---|---|
-y, --yes | bool | false | Run setup wizard and accept defaults automatically |
Unlike no-mistakes attach, bare no-mistakes only auto-attaches to an active run on the current branch.
no-mistakes init
Initialize the gate for the current repository.
no-mistakes initCreates a local bare repo, installs the post-receive hook, best-effort isolates the gate repo’s hook path from shared git config changes when Git supports config --worktree, adds the no-mistakes git remote, detects the default branch, records the repo in SQLite, and ensures the daemon is running, installing the managed service when available and falling back to a detached daemon otherwise.
Rolls back all changes if any step fails.
no-mistakes eject
Remove the gate from the current repository.
no-mistakes ejectRemoves the no-mistakes remote, deletes the bare repo directory, cleans up worktrees, and deletes the database record (cascades to runs and steps).
no-mistakes attach
Attach to the active pipeline run.
no-mistakes attach [--run <id>]| Flag | Type | Default | Description |
|---|---|---|---|
--run | string | (none) | Attach to a specific run ID instead of the active run |
Opens the TUI for the active run anywhere in the current repo. If --run is specified, attaches to that specific run regardless of branch. Unlike bare no-mistakes, this does not stay branch-scoped before falling back.
no-mistakes rerun
Rerun the pipeline for the current branch.
no-mistakes rerunStarts a new pipeline run using the last-known head SHA on the current branch. Useful for retrying after a fix or configuration change.
no-mistakes status
Show repo, daemon, and active run status.
no-mistakes statusDisplays:
- Repo path and upstream URL
- Gate path
- Daemon status (running/stopped, PID)
- Active run details: ID, branch, status, head SHA, start time
no-mistakes runs
List recorded pipeline runs for the current repo.
no-mistakes runs [--limit <n>]| Flag | Type | Default | Description |
|---|---|---|---|
--limit | int | 10 | Maximum number of runs to display |
Shows runs newest-first with branch, status (styled), short SHA, timestamp, and PR URL if set.
no-mistakes doctor
Check system health and dependencies.
no-mistakes doctorChecks:
gitbinaryghCLI (optional, needed for GitHub PR and CI steps)- Data directory (
~/.no-mistakes/) - SQLite database
- Daemon status
- Agent binaries:
claude,codex,acli,opencode
Uses indicators: ✓ (available), – (not found, optional), ✗ (problem detected).
doctor currently checks gh availability only. For GitLab PR and CI steps, install and authenticate glab. For Bitbucket Cloud PR and CI steps, set NO_MISTAKES_BITBUCKET_EMAIL and NO_MISTAKES_BITBUCKET_API_TOKEN.
no-mistakes update
Update the installed binary and reset the daemon.
no-mistakes updateDownloads the latest release, verifies the SHA-256 checksum, atomically replaces the running binary, and resets the daemon when it is running or stale daemon artifacts exist so the new executable is picked up, preferring the managed service path and falling back to a detached daemon if service startup is unavailable or fails. If the daemon is running, update first requires it to already be using the same executable path as the binary running no-mistakes update; if that daemon executable path cannot be determined or it points to a different binary, the update aborts before replacement. If the daemon does not come back cleanly after a successful replacement, the command reports that failure. On macOS, removes the quarantine extended attribute.
Because update installs the latest official release binary, the replacement binary may already have telemetry enabled if a telemetry website ID was embedded at build time.
Background update checks run automatically on each CLI invocation (except update itself). If a newer version is available, a notification is printed to stderr. Suppressed for dev builds or when NO_MISTAKES_NO_UPDATE_CHECK=1 is set.
no-mistakes daemon start
Start the daemon, installing or refreshing the managed service when possible.
no-mistakes daemon startPrefers the managed service path and falls back to a detached daemon if service install or startup is unavailable or fails.
no-mistakes daemon stop
Stop the running daemon process.
no-mistakes daemon stopThis does not remove the managed service. A later no-mistakes, no-mistakes daemon start, init, attach, rerun, or update can start the daemon again through the same service manager when available, or as a detached daemon otherwise.
no-mistakes daemon restart
Restart the daemon.
no-mistakes daemon restartStops the current daemon and starts it again. This works whether the daemon is currently running or not.
no-mistakes daemon status
Check whether the daemon is running.
no-mistakes daemon statusShows the PID if the daemon is running.