Set up a workspace#

To work in Unity Version Control (UVCS), you need a repository. Inside your repository, you can create a workspace, which is a local copy of a project.

Create a workspace in the GUI#

You can create a workspace when you create a repository, or you can create a workspace for an existing repository.

1. Select the repository dropdown menu.
2. Select Open or create other workspace.
3. Select Create a new workspace.
4. Configure the workspace.
   1. Select a repository.
   2. Name the workspace.
   3. Select a location for the files.
5. Select Create.

Create a workspace in the CLI#

1. To create a new workspace, use the cm workspace create command:

   >cm workspace create quakewk quake_path --repository=quake@localhost:6060
   Workspace quakewk has been correctly created

2. Go to your newly created directory:

   >cd quake_path
   >cm status
   /main@quake@localhost:6060 (cs:0 - head)

   By default, the workspace uses the main branch.

3. To check the latest changeset on the branch, run cm status --head:

   >cm status --head
   cs:573@quake@localhost:6060

4. Run update to update to the latest changeset:

   cm update

   The command provides information about the copied files until you’re up to date with the latest changeset.