ait-native
Browse RC.6 documentation
RC.6 Documentation revision 18

ait task — Complete Reference

Create Plan-bound work, inspect Task state and readiness, report usage, cancel eligible work, and complete closeout.

Audience: Coding agents and maintainers

Open Command Manual

Operating boundary#

Purpose: Create Plan-bound work, inspect Task state and readiness, report usage, cancel eligible work, and complete closeout.

Effect class: Task lifecycle and bound-workspace mutation; land advances the configured target only after admission.

Coverage: 8 public help surfaces under ait task.

The blocks below preserve the RC.6 binary output in full, including every emitted argument, option, default, possible value, conflict, and requirement.

Complete command tree#

Code · text
ait task
ait task start
ait task list
ait task show
ait task tokens
ait task audit
ait task land
ait task canceled

Exact emitted help#

ait task#

Reference description: Create Plan-bound work, inspect Task state and readiness, report usage, cancel eligible work, and complete closeout.

The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.

Code · text
Usage: ait task <COMMAND>

Commands:
  start     Start sprint work from one file-backed Plan item, or use an explicit title only when sprint mode is off; --from owns scoped Plan sync and taskability validation
  list      
  show      
  tokens    
  audit     
  land      Land one task or change using workflow-mode scope defaults. solo_local lands only local draft state and, when the final Change finishes a bound Task, closes and locally syncs its exact Plan item. Final-Task closeout removes the worktree and archives the exact accepted-head feature Line. Remote closeout consumes an already-ready Patchset and leaves Plan state untouched; it archives the matching local and remote feature Line. --local or --remote overrides the configured scope.
  canceled  
  help      Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

ait task start#

Binary description: Start sprint work from one file-backed Plan item, or use an explicit title only when sprint mode is off; --from owns scoped Plan sync and taskability validation

Code · text
Start sprint work from one file-backed Plan item, or use an explicit title only when sprint mode is off; --from owns scoped Plan sync and taskability validation

Usage: ait-cli task start --intent <INTENT> (--from <MARKDOWN_PATH#ITEM_REF> [--title-override <TITLE>] | --title <TITLE>) [OPTIONS]

Options:
      --title <TITLE>
          Unbound Task title; required and available only when sprint mode is off, and forbidden with --from
      --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 Task title deterministically
      --title-override <TITLE_OVERRIDE>
          Exceptional explicit title for --from when the Plan item summary is unsuitable
      --task-only
          Create no initial Change; available only with the sprint-off manual title form
      --change-title <CHANGE_TITLE>
          
      --base-line <BASE_LINE>
          
      --local
          
      --remote <REMOTE>
          
      --verbose
          Show every Task-start progress phase
      --json
          
  -h, --help
          Print help

ait task list#

Reference description: List open Tasks or complete Task history in the selected authority.

The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.

Code · text
Usage: ait task list [OPTIONS]

Options:
      --local            
      --remote <REMOTE>  
      --all              Show complete Task history instead of the bounded open view
      --json             
  -h, --help             Print help

ait task show#

Reference description: Show one Task and its linked Changes and lifecycle state.

The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.

Code · text
Usage: ait task show [OPTIONS] <TASK_ID>

Arguments:
  <TASK_ID>  

Options:
      --local            
      --remote <REMOTE>  
      --repo <REPO>      
      --json             
  -h, --help             Print help

ait task tokens#

Reference description: Report recorded token usage for one Task, optionally grouped by Change, worktree, or model.

The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.

Code · text
Usage: ait task tokens [OPTIONS] <TASK_ID>

Arguments:
  <TASK_ID>  

Options:
      --local            
      --remote <REMOTE>  
      --repo <REPO>      
      --by <BY>          [possible values: change, worktree, model]
      --json             
  -h, --help             Print help

ait task audit#

Reference description: Audit one Task's readiness, linked work, target state, and closeout requirements.

The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.

Code · text
Usage: ait task audit [OPTIONS] <TASK_ID>

Arguments:
  <TASK_ID>  

Options:
      --target-line <TARGET_LINE>  [default: main]
      --remote <REMOTE>            
      --json                       
  -h, --help                       Print help

ait task land#

Binary description: Land one task or change using workflow-mode scope defaults. solo_local lands only local draft state and, when the final Change finishes a bound Task, closes and locally syncs its exact Plan item. Final-Task closeout removes the worktree and archives the exact accepted-head feature Line. Remote closeout consumes an already-ready Patchset and leaves Plan state untouched; it archives the matching local and remote feature Line. --local or --remote overrides the configured scope.

Code · text
Land one task or change using workflow-mode scope defaults. solo_local lands only local draft state and, when the final Change finishes a bound Task, closes and locally syncs its exact Plan item. Final-Task closeout removes the worktree and archives the exact accepted-head feature Line. Remote closeout consumes an already-ready Patchset and leaves Plan state untouched; it archives the matching local and remote feature Line. --local or --remote overrides the configured scope.

Usage: ait task land [OPTIONS] [TASK_OR_CHANGE_ID]

Arguments:
  [TASK_OR_CHANGE_ID]  Task id or change id to land. Scope follows workflow_mode/task_default_scope unless --local or --remote is provided. Clean task worktrees are auto-rebased onto the target line before remote publish.

Options:
      --snapshot-message <SNAPSHOT_MESSAGE>
          
      --summary <SUMMARY>
          
      --tests <TESTS>
          
      --lint <LINT>
          
      --security <SECURITY>
          
      --license <LICENSE>
          
      --author-mode <AUTHOR_MODE>
          
      --model <MODEL>
          
      --reviewer <REVIEWER>
          
      --review-message <REVIEW_MESSAGE>
          
      --target <TARGET>
          
      --mode <MODE>
          [default: direct]
      --local
          Force local draft land even when workflow_mode defaults to remote.
      --remote <REMOTE>
          Force shared remote closeout or completed-local promotion using the named remote.
      --preview
          Show the task land state without mutating remote state or removing a worktree.
      --json
          
  -h, --help
          Print help

ait task canceled#

Reference description: Record the selected Task's cancellation or abandonment disposition in the chosen scope.

The RC.6 binary emits no separate prose description for this surface; the sentence above is editorial context. The complete parser-provided usage and options follow unchanged.

Code · text
Usage: ait task canceled [OPTIONS] <TASK_ID>

Arguments:
  <TASK_ID>  

Options:
      --abandoned                
      --exclude-later-promotion  
      --local                    
      --remote <REMOTE>          
      --json                     
  -h, --help                     Print help

Version authority

Checked against the exact RC.6 source

This page is public documentation, not a second product contract. Use the exact source and distribution contract for release authority.

Open RC.6 Release ↗Distribution Contract ↗CLI Source ↗
Owning component Snapshots
  • ait-coreSNP-8C859807E799
  • ait-serverSNP-25FF61FEEA4C
  • ait-runnerSNP-E50374CBA6E6
  • ait-pythonSNP-DF2C871D5400
  • ait-nodeSNP-46BB35869747