# Hermes Checkpoints

> Copies Hermes saves before a risky change, so you can go back.

**Field:** Artificial Intelligence  
**Category:** Hermes Agent  
**Also known as:** /rollback, hermes chat --checkpoints

## Think of it like

It is like a save point in a game, just before a big jump.

## Definition

Checkpoints are Hermes Agent's way to undo file changes it made. They are off by default, and you turn them on with --checkpoints or in config.yaml. Before a file edit or a risky command such as rm or mv, Hermes saves a snapshot in a hidden git store under ~/.hermes/checkpoints. Your own .git is never touched. The /rollback command lists them and puts files back.

## Example

Hermes deletes the wrong folder while tidying Mia's project. She types /rollback, picks the last snapshot, and the folder is back.

## Example code

```console
hermes chat --checkpoints
/rollback
/rollback 2
```

Turn them on, list them, then restore number 2.

## Why it matters

An agent will sometimes make a bad change. A snapshot turns that into a small mistake, not a lost day.

## Common mistake

Assuming they are on. They are opt-in, so with no flag or setting there is nothing to roll back to.

## Three principles

- **Off by default.** Turn them on.
- **Before risky changes.** Edits, rm, mv.
- **Your .git is safe.** Hidden store.

## Related terms

- [Claude Code Checkpoint](https://learn.benibix.com/term/ai/claude-code-checkpoint)
- [Hermes Terminal Backend](https://learn.benibix.com/term/ai/hermes-terminal-backend)
- [Git](https://learn.benibix.com/term/development/git)

---

Source: https://learn.benibix.com/term/ai/hermes-checkpoints
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
