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 status to check.
  • At least one coding agent you already use (Claude Code, Codex, Amp, ...). Superset launches agents; it doesn't replace your subscriptions.

Download

Apple logoDownload for macOS

On 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.

  1. GitHub CLI: install it if needed, then sign in. You can run gh auth login right inside the app.
  2. Agents: Superset detects Claude Code and Codex automatically. Everything else is configurable later under Settings → Agents.
  3. 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.

On this page