DocsCore ConceptsCheckpoints & Undo

Checkpoints & Undo

Automatic snapshots at every operation. browse, compare, and revert any change the AI makes.

Checkpoints & Undo

HelixMind automatically creates checkpoints at every tool call and chat message. Revert to any previous state instantly.

When Checkpoints Are Created

TriggerWhat's Captured
Session startInitial state
Chat messageConversation snapshot
File read/edit/writeBefore + after file content
Command executionPre-command state
Git commitPre-commit state
File searchSearch context
Feed / config changePre-change state

Each checkpoint stores: conversation history, file snapshots, tool call details, and timestamp.

Storage Limits

LimitValue
Max snapshots per session200
Max total storage50MB
Old snapshotsPruned automatically

Browsing Checkpoints

Via Slash Command

/undo

Opens the interactive checkpoint browser:

KeyAction
Up/DownNavigate between checkpoints
EnterSelect checkpoint to revert
ESCCancel

Via Emergency Stop

ESC ESC (double-tap) โ†’ stops all operations โ†’ opens checkpoint browser.

Revert Options

OptionWhat It Reverts
Chat OnlyConversation history (files unchanged)
Code OnlyFile changes (conversation unchanged)
BothFull state rewind. conversation + all files

Key Points

  • Even with 10 sequential edits, you can go back to any point
  • Checkpoints are per-session: gone when you close the session
  • For permanent safety, use git commits as long-term snapshots
  • Don't worry about the AI breaking things. you can always revert
HelixMind โ€” AI Coding CLI with Spiral Memory