Cloned vs. non-cloned workspaces
A workspace can be either cloned (local) or non-cloned (cloud-only). Understanding the difference helps you decide how to set up your workflow.| Cloned (local) | Non-cloned (cloud-only) | |
|---|---|---|
| Where files live | On your machine, synced with the cloud | Only on the Diversion cloud |
| How to edit files | Use any local editor, IDE, or game engine | Upload files through the web or desktop app |
| Auto-sync | Changes sync bidirectionally — local edits upload automatically, and remote changes download automatically | No local sync needed — everything is already in the cloud |
| Show in Explorer / Finder | Available — opens the file’s location on disk | Not available |
| Open with default app | Available — opens the file with your OS’s associated application | Not available |
| Disk usage | Uses local disk space for the full working copy | No local disk space used |
Creating a new workspace
In the Desktop App:Open the branch and workspace view
Click the branch dropdown in the left sidebar to open the branch and workspace view.
Enter a workspace name
Give your workspace a descriptive name. This is required.In the desktop app, you can also check the Clone this workspace locally option to immediately create a local copy. If you choose to clone, you’ll need to pick a folder name and a directory on your machine.
Renaming a workspace
Right-click the workspace
In the branch and workspace view, right-click on the workspace you want to rename and select Rename.
Enter a new name
The Rename Workspace dialog shows the current name pre-filled. Type in the new name you’d like.
Deleting a workspace
Right-click the workspace
In the branch and workspace view, right-click on the workspace you want to delete and select Delete.
Confirm deletion
The Delete Workspace dialog asks you to confirm. Keep in mind that all uncommitted changes in the workspace will be lost.
If the workspace is cloned locally, you’ll see an additional warning that your local files will remain on disk but will no longer sync with Diversion. You’ll need to check a confirmation checkbox before proceeding.
Cloning a workspace locally (Desktop only)
If you have a workspace that isn’t cloned to your machine yet, you can set up a local synced copy at any time.Right-click the workspace
In the branch and workspace view, right-click on a workspace that isn’t locally cloned and select Clone.
Pick a directory
A directory picker opens — choose where you want the local copy to live on your machine.
Attaching a workspace (Desktop only)
If you moved a repository to a different path on your machine, or if a workspace is not showing up after detaching a portable drive, you can re-attach it to Diversion.Click the 'Attach Workspace' button
On the dashboard, click the Attach Workspace button in the top bar.
Browse to the workspace folder
A directory picker opens. Navigate to the folder containing your workspace (the folder with a
.diversion directory inside it).The workspace folder contains a hidden
.diversion directory that Diversion uses to track workspace state. This folder must remain in place and should not be modified or deleted. To verify it exists, enable hidden files in your file explorer (on Windows: View > Show > Hidden items; on macOS: press Cmd+Shift+.). If it is missing, or if the workspace was deleted from the server or you don’t have permission to access it, you’ll see an error message.Change the folder name without re-cloning
You can change the folder name without re-cloning by following these steps: This is the workspace we will use for the example:
Turn off the agent:
Right-click the Diversion icon in your system tray and select Quit, or end the dv.exe task in the Task Manager.Option a:
Restart the agent:
Run the command dv in your command line and verify it starts successfully. Alternatively, open the desktop app and click “start agent” when prompted.Option a:
Reattach your workspace:
Since the folder was renamed, the workspace will not be displayed. Click Attach Workspace.
