ait task — Complete Reference

ait task
ait task start
ait task list
ait task show
ait task audit
ait task land
ait task abandon

Start, inspect, audit, land, or abandon scoped Task lifecycle authority.

Usage: ait task <COMMAND>

Commands:
  start    Start one Task and its initial Change in the configured scope or an explicit local/remote compatibility scope; sprint mode uses one exact file-backed Plan item
  list     List the bounded open Task inventory or complete history in one selected scope
  show     Show one Task record from one selected scope
  audit    Read-only audit of one Task against logical main in one selected scope
  land     Land one Task or Change onto logical main with fixed direct mode. The configured workflow mode selects local or remote authority unless mutually exclusive --local or --remote explicitly chooses the compatibility scope. Local land consumes an existing Snapshot; remote land consumes an already-ready selected Patchset. Final Task closeout removes the bound worktree and archives its accepted-head feature Line.
  abandon  Permanently abandon one Task lineage in the configured scope or an explicit local/remote compatibility scope
  help     Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

Start one Task and its initial Change in the configured scope or an explicit local/remote compatibility scope; sprint mode uses one exact file-backed Plan item

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

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
      --local                          Force local authority even when the configured workflow mode defaults to remote
      --remote <REMOTE>                Force the named remote authority even when the configured workflow mode defaults to local
      --json                           Emit the complete machine-readable Task-start result
  -h, --help                           Print help

List the bounded open Task inventory or complete history in one selected scope

Usage: ait task list [OPTIONS]

Options:
      --local            Read local Task authority even when the configured workflow mode defaults to remote
      --remote <REMOTE>  Read Task authority from the named remote even when the configured 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 Task record from one selected scope

Usage: ait task show [OPTIONS] <TASK_ID>

Arguments:
  <TASK_ID>  

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

Read-only audit of one Task against logical main in one selected scope

Usage: ait task audit [OPTIONS] <TASK_ID>

Arguments:
  <TASK_ID>  

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

Land one Task or Change onto logical main with fixed direct mode. The configured workflow mode selects local or remote authority unless mutually exclusive --local or --remote explicitly chooses the compatibility scope. Local land consumes an existing Snapshot; remote land consumes an already-ready selected Patchset. Final Task closeout removes the bound worktree and archives its accepted-head feature Line.

Usage: ait task land [OPTIONS] <TASK_OR_CHANGE_ID>

Arguments:
  <TASK_OR_CHANGE_ID>  Task id or change id to land onto logical main with fixed direct mode. Scope follows workflow-mode unless --local or --remote is provided.

Options:
      --local            Force local draft land 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 complete machine-readable land and closeout result
  -h, --help             Print help

Permanently abandon one Task lineage in the configured scope or an explicit local/remote compatibility scope

Usage: ait task abandon [OPTIONS] <TASK_ID>

Arguments:
  <TASK_ID>  

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