Installation

Supacode currently targets macOS only and is built as a native app around SwiftUI, The Composable Architecture, and GhosttyKit.

Requirements

• macOS 26.0 or newer
• Git installed and available in your shell
• GitHub CLI installed if you want PR and CI features: gh auth status
• mise if you are building the app from source

Build from source

make build-ghostty-xcframework
make build-app
make run-app

Development commands

make check
make test
make format

First-run checklist

• Open Supacode
• Add a repository
• Decide which editor should open worktrees by default
• If you use GitHub PR workflows, enable GitHub CLI integration

Next

• Your First Repository
• Your First Worktree
• Settings and Storage