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 |
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 and the guide to rolling back an agent's 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.
- Claude Code: Checkpointing. Checked .
- Flywrite docs: Checkpoints & versions. Checked .
- Flywrite docs: Writing with Codex. Checked .
- Flywrite docs: Writing with Cursor. Checked .
- Flywrite docs: GitHub backup & sync. Checked .