00110fb3c3
- 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
31 lines
1.1 KiB
Markdown
31 lines
1.1 KiB
Markdown
# 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
|
|
|
|
```yaml
|
|
# ~/.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](../checkpoints-and-rollback.md)**.
|