Workspaces

Core Concept

Each workspace = one git branch. Workspaces are isolated git worktrees with their own directory, terminal, and ports.

Create Workspaces

Press ⌘N or click "New Workspace". Create from:

New branch - Fresh branch from main
Existing branch - Continue work on a branch
Pull request - Review or continue a PR

Each workspace gets:

Own git branch
Own working directory
Own terminal sessions
Workspace-scoped port detection and controls

Import Worktrees

If you have existing git worktrees on disk, use the Import tab in the New Workspace modal to bring them into Superset. Click Import all to bulk-import all discovered worktrees at once.

Ahead/Behind Status

For local (branch-based) workspaces, the sidebar shows how far the active branch is ahead or behind its remote branch:

↑N - N commits ahead of remote (unpushed)
↓N - N commits behind remote (needs pull/rebase)

Use Cases

Parallel features - Work on multiple features simultaneously
AI agents - Run Claude Code in separate workspaces
Code review - Review PRs while continuing your work

Best Practices

Use descriptive branch names: feature/auth, fix/login-bug
Don't work directly on main
Delete workspaces after merging