Skip to main content
Once you’ve installed Conductor, it’s time to add your first repository. You can add a repo from a local folder or from a Git URL. Add Repo
Conductor requires you to be logged in to GitHub in your terminal environment. To confirm you’re logged in, run gh auth status in your terminal.

​
New workspace

After you add a repo, Conductor will create a new workspace for you. New Workspace
Each workspace is an isolated copy and branch of your Git repo. Conductor only copies files tracked in git, but you can use a setup script to automatically copy files (like .env or run pnpm install) into the workspace. We’ll get to that later!

​
Creating additional workspaces

You can create new workspaces at any time by using ⌘⇧N or clicking the three dots (•••) button next to the “New workspace” button. Create workspace from button This allows you to create a workspace from:
  • A specific branch
  • A GitHub pull request
  • A Linear issue
This is useful when you want to work on multiple features in parallel or start work on an existing issue or PR. You now have two choices:
  1. You can open the workspace in your favorite IDE (⌘O) and keep developing there.
  2. You can use the built in chat to ask Claude Code to help you with your project.
Next, let’s learn the Conductor workflow →.