Checkpoint branches
A checkpoint branch is an engine line on the graph: a named fork of snapshots. It is not git branch. Creating one does not touch git refs, remotes, or your working tree’s git HEAD.
Create a line
- Graph / Timeline: fork from a node
- Command palette: Knox: Create Checkpoint Branch, Switch, Merge, Delete
- Agent tool:
builtin_workspace_checkpointcreate_branchwithname(optionalcheckpoint_id; defaults to newest).listshowslabel=andbranch=
Restore and delete on a branch still prompt.
Use a branch when you want to compare “what if Knox takes path A” against the main checkpoint line without making a git branch. Recipe adapt may fork a what-if/* line before applying so you can compare with a model-written result.
Merge / switch / delete
These operate on checkpoint metadata and blobs, not git. Merging a checkpoint branch does not run git merge.
If you also need a git branch for a PR, create that in Source Control yourself after you like the files.