Snapshot

A snapshot is one captured state of a project’s workspace. They form a lineage, so a project’s history reads as a tree rather than a flat list.

Command	Does
aura snapshot list	List the project’s snapshots as a lineage tree (--flat for newest-first)
aura snapshot file list <ref>	List the files captured in one snapshot
aura snapshot file read <ref> <path>	Print one file from a snapshot to stdout
aura snapshot tag list	List the project’s tags and what they point at
aura snapshot tag set <name> <snapshot-id>	Point a tag at a snapshot, creating or moving it

A <ref> is a snapshot id or a tag name. aura project checkout <id> <ref> resets a workspace to one.

snapshot list prints KIND, LABEL, TAGS and SOLUTION per row, so picking out the solves or the ones you named is a matter of reading the table. To query by those — server-side, without pulling the history — use listSnapshots from either SDK.

LABEL is a snapshot’s title and TAGS are its addresses: only a tag works as a <ref>, so tag the snapshot you want to reach by name.