# Checkpoint

A checkpoint is a saved state of your files you can go back to. How Claude Code's checkpoints work, how a project checkpoint differs and which undoes what.

**Definition:** A checkpoint is a saved state of your files that you can return to later, so you can undo what an AI agent, or you, changed since it was saved.

## Two kinds you'll meet

Agents and apps both use the word, for different things:

| | Claude Code checkpoint | Flywrite checkpoint |
| --- | --- | --- |
| Saved | Before each prompt you send | When Claude Code starts, when Cursor Agent starts after its setup, or when you press ⌘⇧C |
| Covers | Files Claude Code's edit tools changed in the session | The whole project folder |
| Restore with | [`/rewind`](/glossary/claude-code-rewind) | The Versions panel: the whole project or one file |
| Kept | The 100 most recent in a session, deleted about 30 days later by default | In the project's history until you turn checkpoints off for it |

## Where each falls short

- **Claude Code's checkpoints** don't track a file that only shell commands changed, most subagent edits, or edits made outside Claude Code. Anthropic's docs say they're for quick recovery within a session, not a replacement for Git.
- **A project checkpoint** is only as recent as the last time one was saved. Save one before an agent starts, so the state you want back is there.

## In Flywrite

Flywrite saves a checkpoint of the whole project when Claude Code starts in its terminal, and when Cursor Agent starts after its one-time setup. Codex and other CLI agents don't trigger it, so press ⌘⇧C before you start them. To roll back what the agent changed, open Versions (⌘⇧V), expand the checkpoint and restore the project or one file. Restoring the project saves a safety checkpoint first, so even a restore can be undone. Under the hood each checkpoint is a Git commit, and you never type a git command. More in [Checkpoints & versions](/docs/checkpoints-and-versions) and the guide to [rolling back an agent's edits](/guides/review-and-undo-agent-edits).

## Questions

### Does Flywrite save a checkpoint before every agent?

No. It saves one when Claude Code starts in its terminal, and when Cursor Agent starts after its one-time setup. Codex and other CLI agents don't trigger it, so press ⌘⇧C before you start them.

### Is a checkpoint a backup?

Not on its own. Both kinds stay on your computer. For a copy off your computer, connect the project to GitHub and Sync.

## Sources

1. [Claude Code: Checkpointing](https://code.claude.com/docs/en/checkpointing), checked 2026-11-17
2. [Flywrite docs: Checkpoints & versions](/docs/checkpoints-and-versions), checked 2026-11-17
3. [Flywrite docs: Writing with Codex](/docs/writing-with-codex), checked 2026-11-17
4. [Flywrite docs: Writing with Cursor](/docs/writing-with-cursor), checked 2026-11-17
5. [Flywrite docs: GitHub backup & sync](/docs/github-backup-and-sync), checked 2026-11-17

---

This is the Markdown copy of https://flywrite.app/glossary/checkpoint.
