Versions

Rules

• Every project has a Main version — it is always the first in the list and cannot be deleted.
• You can create up to 4 additional versions per project (5 total).
• Versions are independent: switching versions is per-user and does not affect collaborators. Everyone sees their own active version.
• Main is positional, not name-based: renaming the Main version does not remove its Main status.

---

Creating a version

Click the version switcher in the bottom toolbar and choose New version.

Give it a name. The new version starts as a copy of the currently active version.

---

Switching versions

Click the version name in the bottom toolbar to open the version switcher, then click any version to switch to it.

The switch is instant and local to your session.

---

Renaming a version

Double-click the version name in the switcher (or click the edit icon) and type a new name. Press Enter to confirm, Escape to cancel.

---

Replacing a version

Replace one version with the content of another:

1. Open the version switcher.
2. Click the … menu on the version you want to overwrite.
3. Choose Replace with and pick the source version.

This is useful for promoting a branch back into Main after an experiment succeeds.

---

Deleting a version

1. Open the version switcher.
2. Click the … menu on the version.
3. Choose Delete.

Main cannot be deleted.

---

Versions over MCP

AI agents discover available versions via list-connected-projects and switch between them using switch-version.

Typical agent flow:

1. Call list-connected-projects — receives { projectName, versions, activeVersionName }.
2. Call switch-version with the desired versionId and projectName.
3. Read or mutate the canvas in that version.
4. Optionally switch back to Main when done.