Sessions, versions and checkpoints
Every change is a version. Step through them, compare A/B, set checkpoints and undo big changes.
A session holds one animation and its whole history. Every AI answer, feedback chip, applied tuning and applied hand edit adds a version, so nothing is ever lost. The Versions strip shows them in order, each with its number and quality score.
Move between versions
- Click a version in the Versions strip, or press ⌘[ and ⌘] for the previous and next version.
- Press and hold A/B to see the version before; release to come back.
- When you look at an older version, the chat says “Next change builds on v3”. Click Use v5 to go back to the latest.
- Click History (the clock button) to see every version with its origin and time. Checkpoints only narrows the list.
Version context menu
Right-click a version in the strip:
| Command | What it does |
|---|---|
| Name as Checkpoint… / Rename Checkpoint… | Gives the version a name you can find again |
| Remove Checkpoint | Removes the name, keeps the version |
| Continue from This Version | Copies it to the end as a new version |
| Derive Style from This Version | Sets the session style from its timing and curves |
| Export JSON…, Export HTML…, Export Video… | Exports that version |
| Copy as SVG (Figma) | The frame at the playhead, for Figma |
| Delete Version | Removes it, with Undo for 10 seconds |
Edit by hand, then apply
Hand edits collect as a draft, and an Apply bar replaces the Versions strip while you have unsaved changes. Click Apply or press ⌘↩ to save them as a new version, or Discard them. While editing, ⌘Z and ⇧⌘Z undo and redo single steps. See The undo model.
Checkpoints
Press ⌘S (Stage → Set Checkpoint) to mark the current version, named after the time. Checkpoints show a bookmark in the strip and are easy to find in History.
Styles across sessions
A session style locks in timing, curves, springs, distances and palette, and the AI follows it. Use Session → New Session in Same Style (⇧⌘N) to start a new animation that feels like the last one, or Session → Derive Style from Current Animation to capture it. Saved styles live in Settings → Styles. See Motion skills and styles.
Troubleshooting
| If this happens | Try this |
|---|---|
| The AI changed an old version, not the latest | You were looking at an older version. The chat line “Next change builds on v3” tells you; click Use v5 first. |
| Apply doesn't appear | There are no unsaved hand edits. Tuning has its own Apply in the Tuning panel. |
| A version you expected is missing | Open History and turn off Checkpoints only. |