Get Started
Install
Requirements, download, and first launch
Requirements
- macOS, Apple Silicon or Intel. A Linux x64 AppImage ships with each release but is experimental; Windows is not yet available.
- Git installed
- GitHub CLI for the PR workflows: optional, and Superset offers to install it during onboarding. Run
gh auth statusto check. - At least one coding agent you already use (Claude Code, Codex, Amp, ...). Superset launches agents; it doesn't replace your subscriptions.
Download
Download for macOSOn an Intel Mac? Download Superset-x64.dmg instead.
First Launch
Onboarding checks your prerequisites with live detection: install or sign in to anything missing and the checklist updates on its own.
- GitHub CLI: install it if needed, then sign in. You can run
gh auth loginright inside the app. - Agents: Superset detects Claude Code and Codex automatically. Everything else is configurable later under Settings → Agents.
- Add a project: point Superset at a local folder or a Git URL.
Using Bedrock, Vertex, OpenRouter, or another provider? See Providers.
Staying Updated
Superset checks for updates automatically. New releases ship daily; the changelog rounds up each week's highlights.
Next
You're two minutes in; the next ten are the fun part: Your First Parallel Session.