gsd-new-workspace

You can create an isolated Git workspace by specifying a workspace name, target repositories, and a path. This generates a dedicated directory with independent planning directories, allowing multiple branches to be developed simultaneously without state conflicts.

A worktree strategy links branches as separate working trees within the same Git repository, sharing object storage. A clone strategy creates a fully independent repository copy, completely isolating workspace state from the original repository.

You can set up a custom workspace path and checkout a specific branch by providing the target directory location and branch name parameters during workspace creation. This ensures the isolated workspace opens directly with your desired branch checked out.

You need a standard Git environment installed and appropriate repository access permissions to create isolated workspaces. The workspace creation requires read access to the specified repositories to successfully generate copies or worktrees.

Yes, you can include multiple Git repositories in a single isolated workspace by specifying a comma-separated list of repository names. The workspace generator will create copies or worktrees for each specified repository within the target path.

You should use an isolated workspace when you need completely independent planning directories and separate working trees for collaborative projects. Standard Git branching shares a single working directory, while isolated workspaces maintain separate states for each branch.