Skip to content
DOCS

Versions

Every agent change, and any moment you mark, is a version of your project you can see, compare and restore. No git knowledge needed.

Studio saves versions of your project as you work, so you can always go back. Versions are separate from your own git branches: they never add commits or touch your branches.

VersionMade when
v1, v2…The agent changes the code
m1, m2…You click Mark Version (⇧⌘S, Ctrl+Shift+S on Windows), optionally with a name
a1, a2…Automatically, after you stop saving for a while (turn on in Settings, Versions & Git)

See what changedLink to this section

  • N changed in the editor's status bar opens Changes: everything since the version you're on. Discard a single change, a file, or everything, or Mark Version… to keep them.
  • Current Version in the editor toolbar, or Version History… (⇧⌘H, Ctrl+Shift+H), lists your versions (automatic ones under Automatic). Click one to see what changed in it.
  • The clock icon in the editor toolbar shows the versions that changed the current file.

Restore a versionLink to this section

Click Restore in Version History. Studio shows what will change first. If you have edits that aren't in a version yet, choose Discard and Restore or Mark Version, Then Restore. Until the next restore or agent change, Undo Restore puts your files back.

You can also restore a single file from a version's changes.

How long they're keptLink to this section

Versions older than 90 days are cleaned up once a day for the open project. Change the age in Settings, Versions & Git (30 days to forever); Clean Up Now cleans every project at once. Named versions, the newest 50 and the one you're on are always kept.

Untracked files over 50 MB aren't saved in versions.