ait-native
Browse RC.5 documentation
RC.5 Documentation revision 1

ait snapshot

Record immutable repository state and inspect Snapshot content or ancestry.

Audience: Coding agents and maintainers

Open PDF

Role#

Normally created by the coding agent after the bounded implementation and repository checks are complete. Snapshot inspection is safe for users.

Purpose#

ait snapshot records immutable repository state and exposes content, comparison, ancestry, and recovery queries. A Snapshot keeps its authoring Line identity even when a later Change or closeout target moves.

Syntax#

Code · bash
ait snapshot create --message <message>
ait snapshot show <snapshot-id> --files
ait snapshot ancestry <snapshot-id> --ancestors

Snapshot comparison uses two immutable identifiers:

Code · bash
ait snapshot diff <old-snapshot-id> <new-snapshot-id>

Example#

Code · bash
ait snapshot create --message "Add accessible password visibility control"

Run this from the Task workspace after validation. A normal Snapshot records code state; separately authored sprint Markdown remains Plan lineage.

Output#

Create returns the new Snapshot and parent. Show can include the full file inventory, while ancestry queries are bounded unless complete output is explicitly requested.

Failure and recovery#

A dirty or misplaced workspace should be inspected with ait status and ait diff before retrying. Revert and replay operations are separate explicit surfaces; preview their effect before replacing workspace content.

Version authority

Checked against the exact RC.5 source

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

Open RC.5 Release ↗Distribution Contract ↗CLI Source ↗
Owning component Snapshots
  • ait-coreSNP-64B101AAE684
  • ait-serverSNP-0445E16F63EB
  • ait-runnerSNP-2458874F5737
  • ait-pythonSNP-9EE8E9FFF1D1
  • ait-nodeSNP-261F4DA754BE