Use a workspace archive to back up Orbit or move your work to another Mac. Exports include all projects, including archived ones. Imports add new copies of those projects; they do not replace existing ones.
Export a workspace
- Finish saving project and settings drafts.
- Open Settings → Export & import.
- Select Export workspace.
- Choose where to save the ZIP archive and wait for completion.
The archive contains all projects, boards, documents, scratchpads, tags, links, uploaded files, and portable preferences. Repository and linked-folder references are included, but the source code at those paths is not copied into the archive.
What is excluded
Vault secrets, provider and AI credentials, and machine-specific tool settings are excluded. Export selected secrets separately through .env export when needed, and reconnect providers on the destination machine.
The workspace ZIP is not encrypted and contains content from every project. Before sharing it, check that the recipient should receive the whole workspace. For a single-project handover, share that project’s required material separately.
Import an archive
- Open Settings → Export & import → Choose archive.
- Select an Orbit workspace ZIP.
- Review its export date and counts for projects, tasks, documents, and files.
- Choose whether to apply the imported appearance, sounds, startup, and task-column preferences.
- Save or discard any existing settings drafts.
- Select Import workspace and wait for completion.
Custom project statuses are merged. Applying preferences changes the selected workspace preferences; leave that option off if you want to keep the current ones.
The import archive must be no larger than 256 MB. A rejected or invalid ZIP needs to be replaced with a valid Orbit export before retrying.
Existing projects are preserved
Import creates new projects. It does not replace or merge the existing project records. Importing the same archive twice creates another copy, so check the project list before retrying after an uncertain result.
Free imports must keep the total at three or fewer saved projects, including archived projects. Activate Pro before importing a larger archive.
Finish on a new machine
After importing:
- Restore or clone your source code separately, then relink folders to their new locations.
- Reconnect GitHub, GitLab, and any scratchpad AI provider you use.
- Check tool paths if your projects need them.
- Set up the secrets vault and import any separately transferred .env files into the matching projects and environments.
- Refresh repository activity and run dependency checks to get current results.
If Orbit asks for Refresh settings, refresh and review the current values before retrying the import. Keep the original archive until you have verified the restored projects and files.