ait task — Complete Reference

ait task
ait task start
ait task list
ait task show
ait task audit
ait task finish
ait task abandon

Start, inspect, check, finish, or abandon Tasks locally or on a remote.

Usage: ait task <COMMAND>

Commands:
  start    Start one Task and its initial Change locally or on a remote; sprint mode uses one specific file-backed Plan item
  list     List open Tasks or complete Task history locally or on a remote
  show     Show one local or remote Task
  audit    Check one local or remote Task against main without changing it
  finish   Finish one Task or selected Change onto main. The configured workflow mode chooses local or remote unless --local or --remote explicitly overrides it. Dirty local work requires --message to create its final Snapshot; clean local work reuses the current Line head. Remote finish consumes an already-ready selected Patchset and rejects --message. Final Task cleanup removes the bound worktree and archives its accepted-head feature Line.
  abandon  Permanently abandon one local or remote Task and cancel its open Changes
  help     Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

Start one Task and its initial Change locally or on a remote; sprint mode uses one specific file-backed Plan item

Usage: ait task start --intent <INTENT> (--from <MARKDOWN_PATH#ITEM_REF> | --title <TITLE>) [--edit-root <ABSOLUTE_PATH>] [--local | --remote <REMOTE>] [--json [--full]]

Options:
      --title <TITLE>                  Unbound Task title; required and available only when sprint mode is off
      --intent <INTENT>                Required Task intent in both manual and --from modes
      --from <MARKDOWN_PATH#ITEM_REF>  Sprint-only exact file-backed Plan source; syncs, validates, binds, and derives the Task and initial Change title deterministically
      --edit-root <ABSOLUTE_PATH>      Use this safe absolute path as the Task worktree; omit it to keep automatic managed worktree allocation
      --local                          Start the Task locally even when the workflow mode defaults to a remote
      --remote <REMOTE>                Start the Task on the named remote even when the workflow mode defaults to local
      --json                           Emit the compact versioned machine-readable Task-start result
      --full                           With --json, emit the previous complete Task-start result
  -h, --help                           Print help

List open Tasks or complete Task history locally or on a remote

Usage: ait task list [OPTIONS]

Options:
      --local            List local Tasks even when the workflow mode defaults to a remote
      --remote <REMOTE>  List Tasks from the named remote even when the workflow mode defaults to local
      --all              Show complete Task history instead of the bounded open view
      --json             Emit the selected Task inventory as machine-readable JSON
  -h, --help             Print help

Show one local or remote Task

Usage: ait task show [OPTIONS] <TASK_ID>

Arguments:
  <TASK_ID>  

Options:
      --local            Read the local Task even when the workflow mode defaults to a remote
      --remote <REMOTE>  Read the Task from the named remote even when the workflow mode defaults to local
      --json             Emit the complete machine-readable Task record
  -h, --help             Print help

Check one local or remote Task against main without changing it

Usage: ait task audit [OPTIONS] <TASK_ID>

Arguments:
  <TASK_ID>  

Options:
      --local            Check the local Task even when the workflow mode defaults to a remote
      --remote <REMOTE>  Check the Task on the named remote even when the workflow mode defaults to local
      --json             Emit the complete machine-readable audit and recommended action
  -h, --help             Print help

Finish one Task or selected Change onto main. The configured workflow mode chooses local or remote unless --local or --remote explicitly overrides it. Dirty local work requires --message to create its final Snapshot; clean local work reuses the current Line head. Remote finish consumes an already-ready selected Patchset and rejects --message. Final Task cleanup removes the bound worktree and archives its accepted-head feature Line.

Usage: ait task finish [OPTIONS] <TASK_OR_CHANGE_ID>

Arguments:
  <TASK_OR_CHANGE_ID>  Task ID or Change ID to finish onto main. The workflow mode chooses local or remote unless --local or --remote is provided.

Options:
      --message <MESSAGE>  Create the final Snapshot from dirty local work before finishing; clean local work reuses the current Line head. Remote finish rejects this option.
      --local              Force local draft finish even when the configured workflow mode defaults to remote
      --remote <REMOTE>    Force closeout through the named remote's already-ready selected Patchset even when the configured workflow mode defaults to local
      --json               Emit the compact versioned machine-readable finish and closeout result
      --full               With --json, emit the previous complete finish and closeout result
  -h, --help               Print help

Permanently abandon one local or remote Task and cancel its open Changes

Usage: ait task abandon [OPTIONS] <TASK_ID>

Arguments:
  <TASK_ID>  

Options:
      --local            Abandon the local Task even when the workflow mode defaults to a remote
      --remote <REMOTE>  Abandon the Task on the named remote even when the workflow mode defaults to local
      --json             Emit the complete machine-readable terminal Task record
  -h, --help             Print help