Skip to content
BENIBIX Learn

Hermes Checkpoints

AI🪽 Hermes AgentHermes Tools

Also known as /rollback, hermes chat --checkpoints

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

Think of it like

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

Example

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

Why it matters

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

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 code

console
hermes chat --checkpoints
/rollback
/rollback 2
Turn them on, list them, then restore number 2.

Common mistake

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

Key takeaways

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