Command Reference

Complete CLI reference for all ait subcommands

Task Management

Command	Description
`ait create`	Create a new task as draft, or finalize drafts (interactive or batch mode)
`ait ls`	List and filter tasks by priority, effort, status, labels
`ait update`	Update task metadata (status, priority, labels, etc.)
`ait sync`	Sync task data with remote (push/pull)
`ait git`	Run git commands against task data (worktree-aware)
`ait git push`	Best-effort push of task data; warns when commits are stranded
`ait git-health`	Diagnose the `.aitask-data` worktree state (detached HEAD, stuck rebase/merge)
`ait lock`	Lock/unlock tasks to prevent concurrent work
`ait note`	Send durable advisory context to a task that already exists
`ait note read`	Record a read receipt so acknowledged notes stop surfacing

TUI

Command	Description
`ait board`	Open the kanban-style TUI board
`ait codebrowser`	Launch the code browser TUI
`ait monitor`	Dashboard of every code-agent and TUI pane across all aitasks tmux sessions
`ait minimonitor`	Narrow sidebar variant of monitor for tmux agent panes
`ait applink`	Pair the mobile companion app to your workspace over LAN (QR bootstrap)
`ait frozenagent`	View a frozen code agent’s captured output and restore, re-pick or drop it
`ait stats-tui`	Pane-based viewer for archived task completion statistics
`ait ide`	Start (or attach to) the configured tmux session and launch `ait monitor` — one view of a shared session; see `ait ide --help`
`ait settings`	Open the settings TUI for configuration management
`ait syncer`	Open the remote-desync syncer TUI for `main` and `aitask-data`

Integration

Command	Description
`ait issue-import`	Import tasks from GitHub/GitLab/Bitbucket issues
`ait issue-update`	Update or close linked GitHub/GitLab/Bitbucket issues
`ait pr-import`	Import pull requests as tasks or extract PR data for AI analysis

Cross-repo

Command	Description
`ait projects`	Manage the linked-project registry (`list`, `add`, `remove`, `update`, `prune`, `doctor`, `resolve`, `exec`) — see Multi-Project and Cross-Project Dependencies

Agent Orchestration

Command	Description
`ait crew`	Initialize and run multi-agent crews — `init`, `addwork`, `setmode`, `status`, `command`, `runner`, `report`, `cleanup`, `dashboard`, `logview` (see Agentcrews)

Gates

Command	Description
`ait gates run`	Run a task’s verification gates and record each result
`ait gates status`	Show the recorded state of each of a task’s gates (also `list`, `unlocked`)
`ait gates sync-registry`	Reconcile `aitasks/metadata/gates.yaml` with the framework’s gate reference
`ait gate pass`	Sign off a human gate (also `fail`, `log`)

Reporting

Command	Description
`ait stats`	Show task completion statistics
`ait changelog`	Gather changelog data from commits and archived plans

Tools

Command	Description
`ait codeagent`	Manage code agent and model configuration
`ait skillrun`	Launch a code agent with a profile-aware aitask skill
`ait explain-runs`	Manage aitask-explain run directories (list, delete, cleanup)
`ait explain-cleanup`	Remove stale aitask-explain run directories
`ait zip-old`	Archive old completed task and plan files into `tar.zst` bundles — periodic maintenance (guide)

Infrastructure

Command	Description
`ait setup`	Install/update dependencies and configure Claude Code permissions
`ait upgrade`	Update aitasks to latest or specific version

Usage Examples

ait setup                               # Install dependencies
ait create                              # Interactive task creation (draft workflow)
ait create --batch --name "fix_bug"     # Create draft (no network needed)
ait create --batch --name "fix_bug" --commit  # Create and finalize immediately
ait create --batch --finalize-all       # Finalize all draft tasks
ait ls -v 15                            # List top 15 tasks (verbose)
ait ls -v -l ui,frontend 10             # Filter by labels
ait update --batch 42 --status Done     # Mark task done
ait board                               # Open TUI board
ait codebrowser                         # Open code browser TUI
ait monitor                             # Dashboard of all agent/TUI panes
ait projects list                       # List registered linked projects
ait skillrun pick --profile fast 42     # Launch a code agent on task 42
ait crew init --id sprint1 --batch      # Initialize a multi-agent crew
ait gates run 42                        # Run task 42's verification gates
ait gates status 42                     # Show each gate's recorded state
ait gates sync-registry --dry-run       # Preview a gate-registry reconcile
ait gate pass 42 review_approved        # Sign off a human gate
ait git-health                          # Diagnose the .aitask-data worktree
ait issue-import                        # Import issues from issue tracker
ait lock 42                             # Pre-lock a task before Claude Web
ait lock --list                         # See all active locks
ait lock --unlock 42                    # Release a lock
ait note 357 --from 349 --text "..."    # Send a durable note to task 357
ait note read 357 --by 357 --ids <id>   # Acknowledge a note
ait sync                               # Interactive sync with progress
ait sync --batch                        # Batch mode for scripting
ait git add aitasks/t42.md              # Git operations on task data
ait git push --batch                    # Best-effort push with a status line
ait stats                               # Show completion stats
ait explain-runs --list                  # List all explain runs
ait explain-runs --cleanup-stale         # Remove stale runs
ait explain-cleanup --dry-run --all      # Preview stale cleanup
ait codeagent list-agents                 # Show available code agents
ait codeagent list-models claudecode      # List Claude models
ait codeagent resolve task-pick           # Show configured agent/model
ait settings                              # Open settings TUI
ait upgrade                              # Update to latest version
ait upgrade 0.2.1                        # Upgrade to specific version
ait --version                           # Show installed version

See also: Repository Maintenance for periodic upkeep commands (zip-old, explain cleanup, changelog, git-health, upgrade), and Multi-Project for the cross-repo ait projects workflow.

Next: Development Guide