Skip to main content

Restore and undo

Open a checkpoint from the Graph or list → Restore. The dialog previews files. A failed restore sets an error and keeps the dialog open (nothing half-applied).

Checkpoint Details compare view with Restore This Checkpoint
Checkpoint Details: compare changes, then Restore This Checkpoint. Extra-file delete stays off unless you opt in.

Restore All (journaled)​

GUI Restore All, skip-confirm, and the agent restore tool all go through journaled restoreCheckpoint: backup + journal + rollback. If something fails mid-way, Knox rolls back the restore itself.

Restore Selected only writes checked paths.

Extra files (default off)​

Files that exist in the live tree but not in the checkpoint show as unchecked extra rows plus:

Also remove files not in this checkpoint

Leave it off unless you intend to delete those files. Extra-file checkboxes stay unchecked until you opt in.

You can also restore Memory Brain with the snapshot (rewind_memory / restore-memory toggle, default off) so semantic memory does not stay ahead of the disk.

Auto undo​

Undo restores the checkpoint before the last edit. Example: snapshots [A, B] plus a dirty workspace → undo A, and the pre-undo dirty tree is saved as the redo target.

Shortcuts:

ActionMacWindows / Linux
Undo checkpoint⌥⌘ZCtrl+Alt+Z
Redo checkpoint⌥⌘YCtrl+Alt+Y
Undo last assistant operation⇧⌥⌘ZCtrl+Shift+Alt+Z
Redo last assistant operation⇧⌥⌘YCtrl+Shift+Alt+Y

Cmd+Z vs Knox undo​

ShortcutWhat it undoes
⌘Z / Ctrl+ZEditor buffer (and Reject diff when a Knox diff is visible)
Knox checkpoint / assistant undoFiles on disk from the last agent snapshot, not a single keystroke in the buffer

Use checkpoint undo after Auto changed many files. Use editor undo while you are typing.

Knox: Show Undo History lists automatic-checkpoint undo. Knox: Undo Last Assistant Operation is the agent-aware path.

Next​

How checkpoints work · Checkpoint Graph · Keyboard shortcuts