# Restore



<DocVideo src="features/restore/restore-version" alt="Clicking a version badge, choosing Restore to v2, and a Project restored to v2 message appearing in chat" width="840" height="800" />

Every assistant message in chat carries a version badge — **v1**, **v2**, and so on. Click any badge and choose **Restore to vN** to bring your project back to how it looked at that point.

## When To Use Restore [#when-to-use-restore]

* **A bad attachment or upload broke your session.** Restore to just before it and keep going, instead of starting a fresh chat and losing your context.
* **The agent solved it a different way than you wanted.** Restore to before that prompt, then describe the approach you actually had in mind.
* **A long back-and-forth burned context without much to show for it.** Restore to the last good point and pick up from there.
* **The agent made a few changes you've decided against.** Restore rather than undoing them by hand.

## How It Works [#how-it-works]

* Pick a version badge and choose **Restore to vN**.
* Your project files, your [agent rules](/docs/features/agent-rules), and the agent's context all go back to that version.
* Chat shows a `Project restored to vN` message, and you continue from there.

<Callout type="warn">
  Work done after the version you restore to is removed from the project. If you
  want to keep it, [Fork](/docs/features/fork) from that version instead — a
  fork leaves the original alone.
</Callout>

## Good To Know [#good-to-know]

* Restore applies to the whole project, not single files. To undo one change, just ask the agent.
* Version numbers only go up. Restoring to v3 from v7 puts you on v8 with v3's contents.
* Later badges still work, so you can move forward again to a version you restored away from.
* If your project is connected to GitHub, the restored state is pushed to your branch.

## When Restore Isn't Available [#when-restore-isnt-available]

* While the agent is running — stop it first.
* When you're already on the latest version.
* On a task that's been merged.
* With viewer access.
