Skip to content
Commandr

Workspace backups

Save your whole workspace — projects, chats and settings — to a single file.

Save a backup

Open Settings → Workspace → Workspace backups and save a .commandr-backup file. It goes in Commandr’s backup folder unless you choose somewhere else; Open backup folder shows it in Finder.

What’s in a backup

Projects, conversations, attachments, tasks, pinned knowledge, your profile, project settings, file-change history, the list of checkpoints, pipeline progress and your model choices.

Your project folders aren’t included, and nor are their git repositories, checkpoint contents, API keys or your sign-in. Back up project folders separately, and keep backups somewhere safe — they hold your private conversations and attachments.

Restore a backup

Choose the file. Commandr checks it before anything changes, saves your current workspace as a backup first, then restarts with the restored data.

Afterwards, reconnect each project to its folder. Project commands are off again and checkpoints are required again, and unfinished pipeline runs need a review before they resume. Your API keys and sign-in stay as they were on this Mac; model choices come from the backup.

Moving to a new Mac

  1. On the old Mac, save a workspace backup.
  2. Copy the backup and your project folders to the new Mac.
  3. Install Commandr, sign in and connect your providers again — keys aren’t in backups.
  4. Restore the backup, then reconnect each project to its folder.