Skip to main content
Documentation
Experimental CLI

Local Lifecycle Commands

Manage an alpha freeze/thaw experiment inside one local repository. Cloud storage and transparent hydration are not implemented.

CommandCurrent behaviorUsage
freeze-initInitialize local tracking for existing chunksdits freeze-init
freeze-statusSummarize locally tracked lifecycle labelsdits freeze-status
freezeMove selected local chunks to another local tier directorydits freeze [FILES]... [OPTIONS]
thawMove selected local chunks back to the hot object directorydits thaw [FILES]... [--all]
freeze-policyList, select, or inspect a local policy presetdits freeze-policy [NAME] [--list]

Initialize and inspect

freeze-init records existing local chunks in the lifecycle tracker. freeze-status reports local counts, bytes, and policy-eligible transitions. Neither command accepts configuration, provider, cost, JSON, or verbosity flags.

dits freeze-init
dits freeze-status

dits freeze

With file paths, moves their chunks to the local tier selected by --tier (cold by default). --all selects all eligible chunks and defaults to archive. --apply-policyapplies the selected local policy. These modes do not upload data.

dits freeze footage/old-take.mov
dits freeze footage/old-take.mov --tier warm
dits freeze --all --tier archive
dits freeze --apply-policy

dits thaw

With file paths, restores locally warm or cold chunks and queues locally archived chunks for the experiment's simulated delay. --allselects every cold or archived chunk. With no paths, the command processes the local thaw queue. There are no expedited, bulk, wait, notify, or provider retrieval options.

dits thaw footage/old-take.mov
dits thaw --all

# Process the local archive thaw queue
dits thaw

dits freeze-policy

Lists or selects one built-in preset. Arbitrary key/value rules, immediate-apply flags, and cloud lifecycle configuration are not part of this command.

dits freeze-policy --list
dits freeze-policy default
dits freeze-policy aggressive
dits freeze-policy conservative

See the lifecycle boundary, maintenance commands, and status and roadmap.