GitHub
GitHub CLI Integration
Connect Supacode to `gh` for pull requests, checks, and workflow runs
Supacode uses the GitHub CLI instead of bundling its own GitHub client.
Requirements
ghinstalled and available in your shellgh auth logincompleted for the host you use- GitHub integration enabled in Settings → GitHub
What Supacode uses gh for
When enabled, Supacode uses gh to:
- discover the repository's default branch
- resolve PRs for worktree branches
- fetch status checks and workflow runs
- merge or close PRs
- re-run failed jobs
- copy CI logs
Settings states
The GitHub settings view surfaces the current state:
- unavailable
- outdated
- not authenticated
- authenticated
If the CLI is missing or too old, Supacode disables the GitHub-specific workflows instead of falling back to a different implementation.
Privacy model
Supacode does not store GitHub credentials. Authentication stays inside gh.