Skip to main content

Use Checkpoints

Checkpoints record the state of your files before the agent edits them, so you can return a session and its files to an earlier point.

Turn checkpoints on​

  1. Open Settings → Checkpoints.
  2. Turn on Enable Snapshots.
  3. Save.

Checkpoints require a Git repository. They are stored separately from your project's commits, so they do not change your branch history.

In a very large repository, the first snapshot can take a while. Reasoning asks whether to keep waiting or to turn snapshots off for that project.

Return to an earlier point​

  1. Hover over a message in the transcript.
  2. Select Revert to here.

Reasoning hides the later messages and restores the files to their state at that message. A banner shows how many messages were reverted; select Redo to bring them back, as long as you have not sent a new message.

You can also return to the point where a to-do item was completed; see Follow task progress.

If snapshots are off, or the folder is not a Git repository, the conversation is reverted but the files are not. The banner tells you which case applies.

See what the session changed​

In Agent Manager, the Session scope of the diff shows the files the current session changed, based on its checkpoints. See Review Agent Manager changes.

Checkpoints support recovery inside a Reasoning session. They do not replace your project's normal version control and backups.