Skip to main content

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_checkpoint create_branch with name (optional checkpoint_id; defaults to newest). list shows label= and branch=

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.

Next​

Checkpoint Graph · Restore and undo · Plan mode