website/docs/user-guide/features/checkpoints.md

Filesystem Checkpoints

Hermes automatically snapshots your working directory before making file changes, giving you a safety net to roll back if something goes wrong. Checkpoints are enabled by default.

Quick Reference

Command	Description
/rollback	List all checkpoints with change stats
/rollback <N>	Restore to checkpoint N (also undoes last chat turn)
/rollback diff <N>	Preview diff between checkpoint N and current state
/rollback <N> <file>	Restore a single file from checkpoint N

What Triggers Checkpoints

• File tools — write_file and patch
• Destructive terminal commands — rm, mv, sed -i, output redirects (>), git reset/clean

Configuration

# ~/.hermes/config.yaml
checkpoints:
  enabled: true          # default: true
  max_snapshots: 50      # max checkpoints per directory

Learn More

For the full guide — how shadow repos work, diff previews, file-level restore, conversation undo, safety guards, and best practices — see Checkpoints and /rollback.