Skip to main content
Workspaces provide isolated environments for parallel development. Each workspace operates on its own branch, with changes rebased to master when complete.
Each workspace can contain multiple tasks. Tasks share the workspace’s file state but have their own conversation context and agent.

​
What You’ll Learn

  • Create and name workspaces
  • Switch between workspaces
  • Rebase changes to master
  • Clean up completed workspaces

​
Creating Workspaces

​
Quick Create

Press Cmd+Shift+N (macOS) or Ctrl+Shift+N (Windows)

​
Step-by-Step

1

Click New Workspace

Click New Workspace in the Top Bar
2

Name Your Workspace

Enter a descriptive name (e.g., feature-auth, bugfix-123)
3

Start Working

You’re now in the isolated workspace with its own branch

​
Naming Conventions

PatternExampleUse For
feature-{name}feature-authNew features
bugfix-{id}bugfix-123Bug fixes
hotfix-{name}hotfix-securityUrgent fixes
experiment-{name}experiment-cachingExperiments

​
Managing Workspaces

​
Viewing All Workspaces

Click All Workspaces in the Top Bar to see all active workspaces.

​
Workspace Hierarchy

​
Switching Workspaces

ActionShortcut
Next WorkspaceCtrl+Tab
Previous WorkspaceCtrl+Shift+Tab
Select SpecificClick All Workspaces

​
Rebasing to Master

When your work is complete, rebase changes to master:
1

Commit Changes

Use Source Control (Ctrl+Shift+G) to stage and commit with a descriptive message
2

Test

Run tests to ensure everything works
3

Rebase

Click Workspace Actions → Rebase to master
4

Clean Up

Click Delete Workspace in the Workspace Bar

​
Cleaning Up Workspaces

​
When to Delete

ScenarioAction
Work rebasedDelete workspace
Experiment failedDelete workspace
Approach supersededDelete workspace
Still activeKeep workspace

​
How to Delete

Click Delete Workspace in the Workspace Bar.
Uncommitted changes are lost when deleting a workspace. Always commit work before deleting.

​
FAQs

Not directly. Create a new workspace with the desired name, rebase changes, then delete the old workspace.
Each workspace duplicates working files. If your project is 500MB, each workspace adds roughly 500MB. The .git directory is shared.
All workspaces are inside the project folder. Deleting the project folder deletes all workspaces.

​
See Also

Workspace Isolation

How isolation works

Parallel Development

Parallel workflow patterns