[opensourcedex]

Superset is a free, open source ai assisted coding project written in TypeScript and released under a custom open-source licence. It has 15,847 GitHub stars, 1,411 forks and 666 open issues, and was last pushed 12 hours ago. On this registry it ranks #20 of 29 tracked projects in AI Assisted Coding, with 5 head-to-head comparisons available. It gained 1,069 stars over the last 30 tracked days.

Superset — Run dozens of AI coding agents in parallel on your machine

What is Superset?

What it is

Superset is an agentic IDE for orchestrating many coding agents in parallel on a developer machine. It lives in the AI-assisted coding and developer-tools ecosystem, and it is aimed at people who run CLI agents such as Claude Code, Codex, or any CLI agent. It can run any agent with the user's own subscription. The project treats each agent as a worker that can run in its own isolated git worktree, with its own branch, terminal, and environment.

The concrete problem it solves is coordination overhead. A developer who runs several coding agents by hand must manage separate terminals, branches, diffs, ports, and attention signals. Superset provides one place to start, monitor, review, and hand off work. It is meant to reduce waiting and switching, so the human can focus on choosing and merging the best result.

Key capabilities

  • It runs many CLI-based coding agents in parallel, with each task isolated in its own git worktree.
  • It tracks agents from a sidebar, using working indicators, completion chimes, and dock badges when attention is needed.
  • It includes a built-in terminal with tabs, splits, presets, persistent sessions, and a rich prompt editor for multiline input and file mentions.
  • It provides a built-in diff viewer for inspecting, commenting on, editing, committing, and pushing agent changes.
  • It can preview running development servers in an in-app browser pane, with ports detected per workspace.
  • It supports scheduled automations for recurring agent sessions, such as issue triage, changelog drafting, and dependency updates.
  • It exposes a CLI, SDK, MCP, and remote access paths, so workspaces can be reached from the desktop app, another machine, or a phone.

Who uses it and how

  • Developers use it when they want several coding-agent tasks running at once, instead of one agent in one terminal.
  • Developers can compare parallel worktrees and merge the result that best solves the task.
  • Users with remote machines can connect to another host and reach its workspaces from the desktop app, CLI, or phone.
  • Automation users can schedule agent sessions for overnight issue triage, weekly changelog drafting, or dependency freshness checks.
  • Script users can create workspaces, launch agents, read terminals, and manage automations through the Superset CLI.

Getting started

The provided install path is a macOS download from GitHub releases. Documentation is available at https://docs.superset.sh, and the Superset CLI can be used from a shell.

When to use it — and when not to

Use Superset when you already run CLI coding agents and need parallel worktree orchestration, monitoring, diff review, and scheduled automation. It is a poor fit if you need a non-macOS desktop install, because the provided getting-started link only names macOS. It also does not list a hosted option, database, storage, SMTP, or other self-hosting requirements, so infrastructure expectations are not evident from the facts.

project readme (upstream, from github) — read inline

Run 100+ Coding Agents in Parallel

🌐 Read this in other languages

English | 日本語 | 简体中文 | 繁體中文 | 한국어 | Français | Español | Deutsch | Português | Italiano | Русский | Türkçe | Polski | Nederlands | Bahasa Indonesia | Čeština | Tiếng Việt

GitHub stars GitHub release License Twitter Discord


Claude Code, Codex, or any CLI agent, each in its own isolated worktree.
Spend your time shipping, not waiting.


Download for macOS  •  Documentation  •  Changelog  •  Discord


Code 10x Faster With No Switching Cost

Superset runs CLI-based coding agents in parallel across isolated git worktrees, with built-in terminal, review, and open-in-editor workflows.

  • Run multiple agents simultaneously without context switching overhead
  • Isolate each task in its own git worktree so agents don't interfere with each other
  • Monitor all your agents from one place and get notified when they need attention
  • Review and edit changes quickly with the built-in diff viewer and editor
  • Open any workspace where you need it with one-click handoff to your editor or terminal
  • Reach your workspaces from anywhere via remote hosts, the CLI, the SDK, or MCP

Wait less, ship more.

Features

Parallel Workspaces

Run 100+ coding agents at once, each in its own git worktree with its own branch, terminal, and environment. Compare the results and merge the winner.

Docs →

Agent Monitoring

Track every agent from the sidebar, with working indicators, completion chimes, and dock badges when one needs your attention.

Docs →

Built-in Terminal

Tabs, infinite splits, presets, and persistent sessions that survive restarts. Press ⌘I for a rich prompt editor with multiline editing and @-file mentions.

Docs →

Built-in Diff Viewer

Inspect, comment on, and edit agent changes without leaving the app, then commit and push when it's ready.

Docs →

In-App Browser & Ports

Preview running dev servers in a browser pane. Ports are detected per workspace, so every worktree gets its own preview.

Docs →

Automations

Run agent sessions on a schedule: triage issues overnight, draft the weekly changelog, keep dependencies fresh.

Docs →

Remote Access

Connect another machine and reach its workspaces from anywhere: the desktop app, the CLI, or your phone. Wake offline hosts with a custom command.

Docs →

Superset CLI

Script it from any shell: create workspaces, launch agents, read their terminals, and manage automations with a single binary. If an agent can run a command, it can drive Superset.

Docs →

Command Palette

Jump to any workspace, action, or setting from one search box.

Docs →

Also in the box:

  • Built-in skills: agents come pre-loaded with superset:* skills (orchestrate parallel agents, schedule automations, file feedback, diagnose issues), provisioned automatically at launch
  • Model picker & custom agents: choose a model and reasoning effort at launch, and add any terminal agent with its own icon
  • Workspace setup scripts: automate env setup, dependency installs, and dev servers per workspace
  • Terminal presets: save agent and shell layouts and open them with one keystroke
  • Slack & Linear: spin up workspaces from Slack messages or Linear issues
  • Open in your IDE: one-click handoff to Cursor, VS Code, or any editor
  • Custom themes: build, edit, and import theme files
  • Keyboard shortcuts: every action is remappable via Settings → Keyboard Shortcuts (⌘/)
  • Bring your own providers: connect OpenRouter, Bedrock, Vertex, or Vercel AI Gateway
  • And many more: we ship daily, so this list is perpetually behind. The changelog is the real feature list.

Supported Agents

Superset works with any CLI-based coding agent, including:

Agent Status
 Amp Code Fully supported
 Antigravity CLI Fully supported
 Claude Code Fully supported
 OpenAI Codex CLI Fully supported
 Cursor Agent Fully supported
 Droid Fully supported
 fx Fully supported
 Gemini CLI Fully supported
 GitHub Copilot Fully supported
 Grok Fully supported
 Hermes Fully supported
 Kimi Code Fully supported
 Kiro Fully supported
 Mastra Code Fully supported
 Mistral Vibe Fully supported
 Oh My Pi Fully supported
 OpenCode Fully supported
 Pi Fully supported
 Polygraph Fully supported
Any other CLI agent Works without configuration

If it runs in a terminal, it runs on Superset

Agents get more than a terminal:

  • Model picker: choose a model and reasoning effort when you launch an agent
  • Per-agent settings: tune launch commands, prompt templates, and model overrides in Settings → Agents
  • Custom agents: add any terminal agent with its own icon and it works like a built-in
  • Status and notifications: working indicators, completion chimes, and dock badges when an agent needs you
  • Built-in chat: talk to models in a chat pane, with inline tool approvals and plan review

More Than a Desktop App

Every surface talks to the same workspaces, so you can start a task in the app and check on it from anywhere.

Surface What you get
Desktop App The full IDE: terminals, diff viewer, in-app browser, automations
CLI A single superset binary to manage workspaces, agents, terminals, and hosts from any shell
TypeScript SDK Drive Superset programmatically with @superset_sh/sdk from Node, Bun, or Deno
MCP Server Let Claude Code, Codex, Cursor, and other agents create and manage workspaces themselves

The CLI comes bundled with the desktop app, or install it standalone:

curl -fsSL https://superset.sh/cli/install.sh | sh
# or
brew install superset-sh/tap/superset

An iOS app is coming soon so you can check on your agents from your phone.

Install

Download the desktop app:

All you need installed is Git. gh is optional and unlocks the PR workflows; Superset offers to install it for you.

Development

Want to hack on Superset or contribute a PR? Clone the repository, add it to the installed Superset app, and create a workspace for your change:

git clone https://github.com/superset-sh/superset.git

Then run the development setup from that workspace terminal:

./.superset/setup.local.sh
bun run dev

Run setup.local.sh once in every new worktree. It configures workspace-specific app identity and ports so the development desktop app can run alongside the installed Superset app and other development worktrees.

No Neon account or third-party credentials are needed. setup.local.sh brings up a local Postgres + Electric stack via Docker and seeds a dev account. Sign in with the "Sign in as dev" button (or admin@local.test / supersetdev).

Prereqs: Bun v1.3.14+ (pinned in .bun-version), docker, jq, and caddy, which bun dev runs as the local HTTPS proxy (brew install jq caddy && caddy trust).

See DEVELOPMENT.md for the full guide: what the setup script does, manual setup against real services, common commands, troubleshooting, and how to build the desktop app. Contribution process lives in CONTRIBUTING.md.

Configuration

Configure workspace setup, teardown, and run scripts in .superset/config.json. See full documentation.

{
  "setup": ["./.superset/setup.sh"],
  "teardown": ["./.superset/teardown.sh"],
  "run": ["./.superset/run.sh"]
}

Keyboard shortcuts are customizable via Settings → Keyboard Shortcuts (⌘/); see the full shortcut list.

Tech Stack

Electron React TailwindCSS Bun Turborepo Vite Biome Drizzle ORM Neon tRPC

Private by Default

  • Source Available: full source is on GitHub under Elastic License 2.0 (ELv2).
  • Explicit Connections: you choose which agents, providers, and integrations to connect.

Contributing

We welcome contributions! See CONTRIBUTING.md for how to get set up and open a PR. Bugs and feature requests go in issues.

Community

Join the Superset community to get help, share feedback, and connect with other users:

Team

Avi Twitter Kiet Twitter Satya Twitter

License & what's free forever

The desktop app is free forever. Running agents in parallel on your own machine will never require payment. Anything we charge for will be an optional service on top.

The whole app is in this repo under the Elastic License 2.0: use it, fork it, modify it, self-host it for your team. The only thing off the table is repackaging Superset itself as a service you sell to others.

Frequently asked questions

Is Superset free to use?

Superset is open source. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does Superset do?

Run dozens of AI coding agents in parallel on your machine

What is Superset written in?

Superset is primarily written in TypeScript. Its source is publicly available at https://github.com/superset-sh/superset, and it has 15,847 GitHub stars.