ah branch & ah snapshot
Manage instant Copy-on-Write (CoW) workspace branches and standalone filesystem snapshots.
ah branch Subcommands
| Subcommand | Description |
|---|---|
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
| Subcommand | Description |
|---|---|
ah snapshot create [--label <text>] | Captures an atomic point-in-time CoW snapshot of the current workspace. |
ah snapshot list | Lists 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