Your first workspace

A workspace is a top-level context for a kind of work. It holds one or many projects and carries its own visual theme, agent settings, layout state, and workflow defaults.

Workspaces represent contexts such as personal projects, work projects, clients, or groups of related repositories. Within a Git-backed project, branches and git worktrees isolate individual tasks.

Plain folders open as non-Git projects, but they do not support branch-backed worktrees until you initialize Git.

Start from the welcome screen

On first launch, the welcome screen offers three ways to start:

• Open project adds an existing local project or repository.
• Clone from URL clones a remote repository and adds it.
• Quick start creates a new project from a template.

You need not create a workspace first. When you add your first project, Superconductor creates a workspace and places the project inside it.

After you add the first project, Superconductor shows a short welcome guide with next steps:

• Create worktrees from the + button next to the project title, or with Cmd+N.
• Open project settings from the ... menu or the Settings page.
• Use the starred primary worktree for the project checkout, or create worktrees for branch-backed tasks.

Customize the workspace

Rename the workspace to match its context, such as Personal, Work, or a client name.

Workspace-specific settings include:

• Workspace chrome and accent colors.
• Agent provider and model defaults.
• Action-specific agent routing for workflows such as review, fix CI, or create PR.
• Custom prompt text for the workspace, such as asking PR creation to apply a workspace-specific label.

For example, a work workspace might use a create-PR instruction like Create a PR with the label coderabbit-go, while a personal workspace uses Create a PR with the label coderabbit.

Add a project

1. Use the welcome screen or the sidebar Add Project action.
2. Choose an existing local project, clone from a URL, or use Quick start.
3. Confirm the project appears in the workspace sidebar.
4. Add more projects if the workspace represents a broader context.

Use a Git repository for branch-backed worktrees, branch state, and Git diff review. Plain folders require experimental non-Git projects, and you can initialize them as Git repositories later.

Create task worktrees

For Git projects, create a task worktree from the sidebar or project controls. Give it a branch name, such as fix-login-timeout or docs-search.

Superconductor creates a separate working directory for the task branch and opens a terminal there. Commands run in that terminal target the worktree directory, not the original checkout.

Plain folders cannot create git worktrees. They use the main project folder for terminals and agent sessions until you initialize Git.

Start working

Inside the workspace or selected worktree, you can:

• Run tests or development servers.
• Start an agent CLI.
• Open a chat session when a provider is configured.
• Edit files through your usual tools.
• Review diffs in Superconductor before merging.

When the task is done

Review the worktree changes, run the relevant tests, commit or push if that fits your flow, then clean up the task worktree when you no longer need it.