CLI: Version history
Read the project configuration at any point in time, restore it, and manage timelines and snapshots with sov.
sov chrono state --at 2026-10-15T09:00:00Z --names-only
sov chrono restore 2026-10-15T09:00:00Zsov chrono
Timeline and snapshot operations
sov chrono commit
Create a new chronon commit.
sov chrono commit [OPTIONS]Arguments and options
--timelinetextoptionaldefaultmain--messagetextrequired--authortextrequired--event-typetextoptionaldefaultupdate
- Also takes
--profile,--org,--projectand--envto act on another account, organization, project or environment.
sov chrono timeline-list
List timelines.
sov chrono timeline-list [OPTIONS]- Also takes
--profile,--org,--projectand--envto act on another account, organization, project or environment.
sov chrono timeline-spawn
Spawn a new timeline from a source head.
sov chrono timeline-spawn [OPTIONS] NAMEArguments and options
NAMEtextrequired--source-hex-idtextoptional
- Also takes
--profile,--org,--projectand--envto act on another account, organization, project or environment.
sov chrono timeline-delete
Delete a timeline.
sov chrono timeline-delete [OPTIONS] NAMEArguments and options
NAMEtextrequired
- Also takes
--profile,--org,--projectand--envto act on another account, organization, project or environment.
sov chrono timeline-jump
Force-jump a timeline to a specific head.
sov chrono timeline-jump [OPTIONS] NAMEArguments and options
NAMEtextrequired--target-hextextrequired
- Also takes
--profile,--org,--projectand--envto act on another account, organization, project or environment.
sov chrono timeline-history
Show timeline history.
sov chrono timeline-history [OPTIONS] NAMEArguments and options
NAMEtextrequired--limitintegeroptionaldefault50--offsetintegeroptionaldefault0
- Also takes
--profile,--org,--projectand--envto act on another account, organization, project or environment.
sov chrono topology
Show timeline topology graph.
sov chrono topology [OPTIONS]Arguments and options
--timelinetextoptionaldefaultmain--limitintegeroptionaldefault50
- Also takes
--profile,--org,--projectand--envto act on another account, organization, project or environment.
sov chrono converge
Converge source timeline into target.
sov chrono converge [OPTIONS]Arguments and options
--targettextrequired--sourcetextrequired--authortextrequired--messagetextrequired
- Also takes
--profile,--org,--projectand--envto act on another account, organization, project or environment.
sov chrono variance
Calculate variance between chronons.
sov chrono variance [OPTIONS]Arguments and options
--oldtextrequired--newtextrequired--domain-filtertextoptional
- Also takes
--profile,--org,--projectand--envto act on another account, organization, project or environment.
sov chrono snapshot-create
Create a Chrono snapshot.
sov chrono snapshot-create [OPTIONS]Arguments and options
--messagetextrequired
- Also takes
--profile,--org,--projectand--envto act on another account, organization, project or environment.
sov chrono snapshot-list
List Chrono snapshots.
sov chrono snapshot-list [OPTIONS]- Also takes
--profile,--org,--projectand--envto act on another account, organization, project or environment.
sov chrono snapshot-restore
Restore a snapshot by id.
sov chrono snapshot-restore [OPTIONS] SNAPSHOT_IDArguments and options
SNAPSHOT_IDintegerrequired
- Also takes
--profile,--org,--projectand--envto act on another account, organization, project or environment.
sov chrono state
The project's configuration as it was at a point in time (policies, schema, functions, settings…).
sov chrono state [OPTIONS]Arguments and options
--attextoptional- Commit id or ISO time (default: now)
--prefixtextoptional- Only this folder: policies/, schema/, functions/, settings/, storage/, keys/
--timelinetextoptionaldefaultmain--names-onlyflagoptional- List files without their contents
- Also takes
--profile,--org,--projectand--envto act on another account, organization, project or environment.
sov chrono state --prefix policies/ --names-onlysov chrono restore
Go back to an earlier point: shows what changes back (and who would gain or lose access), then applies it.
sov chrono restore [OPTIONS] ATArguments and options
ATtextrequired- Commit id or ISO time to go back to
--timelinetextoptionaldefaultmain--yesflagoptional- Apply without asking (after showing the plan)
- Also takes
--profile,--org,--projectand--envto act on another account, organization, project or environment.
sov chrono restore 2026-10-15T09:00:00Z # shows the plan, then asks
sov chrono restore 2026-10-15T09:00:00Z --yes # in scriptsSomething unclear or missing on this page?Tell us