Files

Teknium 00110fb3c3 docs: update checkpoint/rollback docs for new features

- Reflect that checkpoints are now enabled by default
- Document /rollback diff <N> for previewing changes
- Document /rollback <N> <file> for single-file restore
- Document automatic conversation undo on rollback
- Document terminal command checkpoint coverage
- Update listing example to show change stats
- Fix config path (checkpoints.enabled, not agent.checkpoints_enabled)
- Consolidate features/checkpoints.md to brief summary with link

2026-03-16 04:56:22 -07:00

1.1 KiB

Raw Blame History

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.

1.1 KiB Raw Blame History