Supacode Docs

Supacode is a native macOS app for running terminal-based coding workflows across multiple git worktrees. It combines repository management, a Ghostty-backed terminal, GitHub CLI integration, and per-repository automation in one window.

Core workflow

1. Install Supacode
2. Add a repository
3. Create a worktree
4. Open it in your editor or use the built-in terminal
5. Configure your repo workflow

What Supacode covers

• repositories and worktrees
• A built-in terminal with tabs, splits, search, and notifications
• GitHub CLI integration and PR / CI workflows
• Repository settings, repository commands, and local storage

Good first reads

• Installation
• Your First Repository
• Your First Worktree
• Repository Commands
• FAQ

A good mental model

Supacode is best thought of as a worktree command center:

• repositories are the top-level container
• worktrees are the unit of parallel work
• the terminal is where the work happens
• GitHub integration adds PR and CI awareness without replacing gh