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

ait worktree — Complete Reference

Inspect, diagnose, recover, relocate, and clean AIT-owned Task worktrees and their metadata.

Audience: Coding agents and repository operators

Open Command Manual

Operating boundary#

Purpose: Inspect, diagnose, recover, relocate, and clean AIT-owned Task worktrees and their metadata.

Effect class: Mixed read and local recovery/cleanup surface; exact ownership checks govern mutations.

Coverage: 16 public help surfaces under ait worktree.

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 worktree
ait worktree status
ait worktree restore
ait worktree show
ait worktree path
ait worktree doctor
ait worktree cleanup-candidates
ait worktree cleanup
ait worktree prune-stale
ait worktree list
ait worktree sync
ait worktree recreate
ait worktree recover-task
ait worktree restore-owned-head
ait worktree rebase
ait worktree remove

Exact emitted help#

ait worktree#

Reference description: Inspect, diagnose, recover, relocate, and clean AIT-owned Task worktrees and their metadata.

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 worktree <COMMAND>

Commands:
  status              
  restore             
  show                
  path                [alias: open]
  doctor              
  cleanup-candidates  
  cleanup             
  prune-stale         
  list                
  sync                
  recreate            
  recover-task        
  restore-owned-head  
  rebase              
  remove              
  help                Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

ait worktree status#

Reference description: Show the state of one named or current AIT-owned worktree.

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 worktree status [OPTIONS] [NAME]

Arguments:
  [NAME]  

Options:
      --snapshot <SNAPSHOT_ID>  
      --line <LINE_NAME>        
      --verbose                 Show baseline and workspace-root detail in text output
      --json                    
  -h, --help                    Print help

ait worktree restore#

Reference description: Restore an eligible named or current worktree from its recorded ownership metadata.

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 worktree restore [OPTIONS] [NAME]

Arguments:
  [NAME]  

Options:
      --snapshot <SNAPSHOT_ID>  
      --line <LINE_NAME>        
      --path <PATHS>            
      --force                   
      --dry-run                 
      --json                    
  -h, --help                    Print help

ait worktree show#

Reference description: Show detailed ownership and binding information for one worktree.

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 worktree show [OPTIONS] [NAME]

Arguments:
  [NAME]  

Options:
      --json  
  -h, --help  Print help

ait worktree path#

Binary description from its parent command: [alias: open]

Code · text
Usage: ait worktree path [OPTIONS] [NAME]

Arguments:
  [NAME]  

Options:
      --shell  
      --json   
  -h, --help   Print help

ait worktree doctor#

Reference description: Diagnose worktree metadata, paths, ownership, and recoverability.

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 worktree doctor [OPTIONS]

Options:
      --refresh  Refresh each worktree's content status before building the doctor report.
      --json     
  -h, --help     Print help

ait worktree cleanup-candidates#

Reference description: Inspect worktrees selected by the emitted age and cleanup-policy filters.

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 worktree cleanup-candidates [OPTIONS]

Options:
      --older-than <OLDER_THAN>  [default: 7d]
      --policy <CLEANUP_POLICY>  
      --allow-manual-only        
      --include-protected        
      --json                     
  -h, --help                     Print help

ait worktree cleanup#

Reference description: Preview or apply bounded cleanup to eligible AIT-owned worktrees.

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 worktree cleanup [OPTIONS]

Options:
      --older-than <OLDER_THAN>  [default: 7d]
      --policy <CLEANUP_POLICY>  
      --allow-manual-only        
      --limit <LIMIT>            
      --dry-run                  
      --yes                      
      --json                     
  -h, --help                     Print help

ait worktree prune-stale#

Reference description: Prune stale worktree metadata admitted by the emitted safety controls.

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 worktree prune-stale [OPTIONS]

Options:
      --dry-run  
      --json     
  -h, --help     Print help

ait worktree list#

Reference description: List AIT-owned worktrees and their Task and Change bindings.

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 worktree list [OPTIONS]

Options:
      --json     
      --refresh  
  -h, --help     Print help

ait worktree sync#

Reference description: Synchronize one named or current worktree with its recorded metadata and target 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 worktree sync [OPTIONS] [NAME]

Arguments:
  [NAME]  

Options:
      --all               
      --line <LINE_NAME>  
      --force             
      --dry-run           
      --json              
  -h, --help              Print help

ait worktree recreate#

Reference description: Recreate an eligible named or current worktree from recorded 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 worktree recreate [OPTIONS] [NAME]

Arguments:
  [NAME]  

Options:
      --dry-run  
      --json     
  -h, --help     Print help

ait worktree recover-task#

Reference description: Preview or recover a Task worktree for an exact Task and Change binding.

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 worktree recover-task [OPTIONS] --change <CHANGE> <TASK_ID>

Arguments:
  <TASK_ID>  

Options:
      --change <CHANGE>  
      --remote <REMOTE>  
      --dry-run          
      --json             
  -h, --help             Print help

ait worktree restore-owned-head#

Reference description: Preview or restore the head owned by one named or current worktree.

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 worktree restore-owned-head [OPTIONS] [NAME]

Arguments:
  [NAME]  

Options:
      --dry-run  
      --json     
  -h, --help     Print help

ait worktree rebase#

Reference description: Rebase one named or current Task worktree onto its selected target 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 worktree rebase [OPTIONS] [NAME]

Arguments:
  [NAME]  

Options:
      --onto <ONTO_LINE>  
      --continue          
      --abort             
      --dry-run           
      --json              
  -h, --help              Print help

ait worktree remove#

Reference description: Remove one or more exact AIT-owned worktrees under the emitted safety controls.

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 worktree remove [OPTIONS] [NAMES]...

Arguments:
  [NAMES]...  

Options:
      --all-stale    
      --delete-path  
      --force        
      --dry-run      
      --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