AITrax CLI reference
aitrax is the native command that performs all AITrax setup and diagnostics. Commands are
grouped by what they change. The commands the tracker runs on its own — the hook, harvest,
and MCP server entry points — are not listed here.
Setup commands
The following table lists the setup commands:
| Command | Purpose |
|---|---|
aitrax setup system | Configure user-level native tracking settings |
aitrax setup check | Print native setup status. It repairs two settings as it runs, so it is not read-only |
aitrax setup reconcile | Self-heal user-level setup drift after an update. No effect unless setup already completed and a surface is missing. Absent from aitrax setup --help |
Uninstall commands
The following table lists the uninstall commands:
| Command | Purpose |
|---|---|
aitrax uninstall system | Remove user-level tracking settings |
aitrax uninstall repo | Remove repository-level tracking settings, including this worktree's entry in the registry |
aitrax uninstall all | Remove user-level and repository-level tracking settings |
The following table lists the flags these commands accept:
| Flag | Purpose |
|---|---|
--dry-run | Report planned removals without changing files or signaling monitors |
--verbose, -v | Print a per-file report of what uninstall changed. Combine with --dry-run for the path inventory described in Files and locations |
--keep-cache | Preserve the cached AITrax binaries and full artifacts |
Diagnostic commands
The following table lists the diagnostic commands:
| Command | Purpose |
|---|---|
aitrax doctor | Print lifecycle diagnostics. Emits the same JSON status document as aitrax setup check, including the path to the repository registry, but changes nothing on the machine. Support tickets ask for its output |
aitrax health | Offline diagnostic rollup of the shared tracker lifecycle log. Prints a verdict, the event span, and a recent-activity table |
aitrax version | Print the embedded build version |
The following table lists the flags aitrax health accepts:
| Flag | Purpose |
|---|---|
--path <dir> | Read the lifecycle log from a directory other than the default |
--json | Emit the rollup as JSON instead of the table |
--since <duration> | Set the lookback window the verdict is computed over, in place of the default |
--all | Drop the lookback window and include every retained event |
--verbose, -v | Include per-event detail |
Related
- How setup works — what these commands do and why every path uses them.
- Files and locations — where these commands read and write.