Skip to Content
CLI ReferenceCommandsah branch & ah snapshot

ah branch & ah snapshot

Manage instant Copy-on-Write (CoW) workspace branches and standalone filesystem snapshots.

ah branch Subcommands

SubcommandDescription
ah branch create <name> [--from <base>]Creates a new CoW filesystem branch cloned from the current workspace (or <base>).
ah branch list [--json]Lists all CoW branches in the current repository along with their CoW backend and disk usage delta.
ah branch exec <name> -- <cmd...>Executes <cmd...> inside the specified CoW branch directory.
ah branch enter <name>Opens an interactive shell inside the CoW branch directory.
ah branch diff <name> [--stat]Outputs the unified diff between the CoW branch and its base workspace.
ah branch file <name> <relative-path>Prints the contents of <relative-path> from inside the CoW branch.
ah branch delete <name> [--force]Deletes the CoW branch and reclaims modified disk blocks.

ah snapshot Subcommands

SubcommandDescription
ah snapshot create [--label <text>]Captures an atomic point-in-time CoW snapshot of the current workspace.
ah snapshot listLists workspace snapshots with timestamps and labels.
ah snapshot restore <snapshot-id>Restores the workspace filesystem to <snapshot-id>.
ah snapshot diff <snapshot-id>Shows the filesystem diff between the current workspace and <snapshot-id>.

Examples

ah branch create feat/zero-copy ah branch exec feat/zero-copy -- cargo test ah branch diff feat/zero-copy ah branch delete feat/zero-copy