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

ait snapshot — Complete Reference

Create and inspect immutable repository state, traverse its parent history, and replay or restore recorded content.

Audience: Coding agents and maintainers

Open Command Manual

Operating boundary#

Purpose: Create and inspect immutable repository state, traverse its parent history, and replay or restore recorded content.

Effect class: Create records immutable state; revert, replay, and restore-related operations change current local state as described.

Coverage: 11 public help surfaces under ait snapshot.

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 snapshot
ait snapshot create
ait snapshot list
ait snapshot show
ait snapshot diff
ait snapshot restore-lines
ait snapshot revert
ait snapshot replay
ait snapshot ancestry
ait snapshot is-ancestor
ait snapshot merge-base

Exact emitted help#

ait snapshot#

Reference description: Create and inspect immutable repository state, traverse its parent history, and replay or restore recorded content.

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

Commands:
  create         
  list           
  show           
  diff           
  restore-lines  Preview or apply an exact line range from one Snapshot into the workspace.
  revert         
  replay         
  ancestry       Query bounded Snapshot ancestors or descendants using metadata-only DAG traversal.
  is-ancestor    Test DAG ancestry; exits 0 when true, 1 when false, and 2 on lookup or storage errors.
  merge-base     Find the deterministic best common Snapshot ancestor.
  help           Print this message or the help of the given subcommand(s)

Options:
  -h, --help  Print help

ait snapshot create#

Reference description: Record the current eligible repository state as a new immutable Snapshot.

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 snapshot create [OPTIONS]

Options:
      --message <MESSAGE>        
      --profile <PROFILE>        [possible values: quick]
      --intent <INTENT>          
      --validation <VALIDATION>  
      --json                     
  -h, --help                     Print help

ait snapshot list#

Reference description: List recorded Snapshots using the emitted scope and filtering options.

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

Options:
      --all   Show complete Snapshot history instead of the bounded recent view
      --json  
  -h, --help  Print help

ait snapshot show#

Reference description: Show one Snapshot and optionally its recorded files or 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 snapshot show [OPTIONS] <SNAPSHOT_ID>

Arguments:
  <SNAPSHOT_ID>  

Options:
      --files  Show the complete Snapshot tree inventory
      --json   
  -h, --help   Print help

ait snapshot diff#

Reference description: Compare the recorded content of two exact Snapshots.

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 snapshot diff [OPTIONS] <OLD_SNAPSHOT_ID> <NEW_SNAPSHOT_ID>

Arguments:
  <OLD_SNAPSHOT_ID>  
  <NEW_SNAPSHOT_ID>  

Options:
      --include-text           
      --max-bytes <MAX_BYTES>  [default: 128000]
      --json                   
  -h, --help                   Print help

ait snapshot restore-lines#

Binary description: Preview or apply an exact line range from one Snapshot into the workspace.

Code · text
Preview or apply an exact line range from one Snapshot into the workspace.

Usage: ait snapshot restore-lines <SNAPSHOT_ID> <PATH> (--line <N> | --start <N> --end <N>) [--yes] [--json]

Arguments:
  <SNAPSHOT_ID>  Exact immutable Snapshot ID to read line content from.
  <PATH>         Existing regular workspace file to update.

Options:
      --line <LINE>         Select one 1-based workspace line.
      --start <START_LINE>  Start of one inclusive 1-based line range.
      --end <END_LINE>      End of one inclusive 1-based line range.
      --yes                 Apply the selected Snapshot lines; omission is always a read-only preview.
      --json                
  -h, --help                Print help

ait snapshot revert#

Reference description: Preview or restore the workspace toward an exact earlier Snapshot.

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 snapshot revert [OPTIONS] <SNAPSHOT_ID>

Arguments:
  <SNAPSHOT_ID>  

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

ait snapshot replay#

Reference description: Preview or replay an exact Snapshot onto the selected destination 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 snapshot replay [OPTIONS] --onto <ONTO> <SNAPSHOT_ID>

Arguments:
  <SNAPSHOT_ID>  

Options:
      --onto <ONTO>  
      --force        
      --dry-run      
      --json         
  -h, --help         Print help

ait snapshot ancestry#

Binary description: Query bounded Snapshot ancestors or descendants using metadata-only DAG traversal.

Code · text
Query bounded Snapshot ancestors or descendants using metadata-only DAG traversal.

Usage: ait snapshot ancestry [OPTIONS] <SNAPSHOT_ID>

Arguments:
  <SNAPSHOT_ID>  

Options:
      --ancestors              
      --descendants            
      --first-parent           
      --max-depth <MAX_DEPTH>  [default: 10000]
      --limit <LIMIT>          [default: 10000]
      --all                    Show every result admitted by --limit instead of nearest evidence
      --json                   
  -h, --help                   Print help

ait snapshot is-ancestor#

Binary description: Test DAG ancestry; exits 0 when true, 1 when false, and 2 on lookup or storage errors.

Code · text
Test DAG ancestry; exits 0 when true, 1 when false, and 2 on lookup or storage errors.

Usage: ait snapshot is-ancestor [OPTIONS] <OLDER_SNAPSHOT_ID> <NEWER_SNAPSHOT_ID>

Arguments:
  <OLDER_SNAPSHOT_ID>  
  <NEWER_SNAPSHOT_ID>  

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

ait snapshot merge-base#

Binary description: Find the deterministic best common Snapshot ancestor.

Code · text
Find the deterministic best common Snapshot ancestor.

Usage: ait snapshot merge-base [OPTIONS] <LEFT_SNAPSHOT_ID> <RIGHT_SNAPSHOT_ID>

Arguments:
  <LEFT_SNAPSHOT_ID>   
  <RIGHT_SNAPSHOT_ID>  

Options:
      --all   
      --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