Your First Worktree

A worktree in Supacode is a real git worktree backed by its own branch and directory. It gives you a clean place to run an agent, a dev server, or a one-off fix without touching your other branches.

Create one

• Press ⌘N
• Or use the repository actions in the sidebar
• If prompted, choose a branch name and base ref
• If not prompted, Supacode creates a worktree with a generated branch name

What happens after creation

A newly created worktree is:

• added to the selected repository in the sidebar
• created under ~/.supacode/repos/<repository-name>/
• selected automatically
• given its own terminal state
• eligible to run the repository's setup script once

What to do next

Most first sessions look like this:

1. Open the worktree in your editor with ⌘O
2. Let the initial terminal open
3. Run your agent or dev command
4. Configure repository commands if the workflow will repeat

Next

• Repository Settings
• Repository Commands
• Terminal