Getting Started
Your First Repository
Add a local git repository and let Supacode discover its worktrees
The first step in Supacode is adding a local repository root. Supacode opens a folder picker and remembers the repositories you add.
Add a repository
- Click Add Repository in the sidebar footer
- Or press ⌘⇧O
- Choose a folder that belongs to a git repository
What Supacode does next
When a repository is added, Supacode:
- resolves the repository root
- loads existing worktrees
- groups them under one repository in the sidebar
- persists the repository so it reappears next time you launch the app
If the selected folder cannot be resolved as a git repository, Supacode keeps it out of the normal list instead of guessing.
Remove vs delete
Removing a repository from Supacode only removes it from the app's saved repository list. It does not delete the repository from disk.