superset

The Code Editor for AI Agents

Orchestrate swarms of Claude Code, Codex, and more in parallel.
Works with any CLI agent. Built for local worktree-based development.

Download for macOS • Documentation • Changelog • Discord

Code 10x Faster With No Switching Cost

Superset orchestrates CLI-based coding agents 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

Wait less, ship more.

Features

Feature	Description
Parallel Execution	Run 10+ coding agents simultaneously on your machine
Worktree Isolation	Each task gets its own branch and working directory
Agent Monitoring	Track agent status and get notified when changes are ready
Built-in Diff Viewer	Inspect and edit agent changes without leaving the app
Workspace Presets	Automate env setup, dependency installation, and more
Universal Compatibility	Works with any CLI agent that runs in a terminal
Quick Context Switching	Jump between tasks as they need your attention
IDE Integration	Open any workspace in your favorite editor with one click

Supported Agents

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

Agent	Status
Amp Code	Fully supported
Claude Code	Fully supported
OpenAI Codex CLI	Fully supported
Cursor Agent	Fully supported
Gemini CLI	Fully supported
GitHub Copilot	Fully supported
OpenCode	Fully supported
Pi	Fully supported
Any CLI agent	Will work

If it runs in a terminal, it runs on Superset

Requirements

Requirement	Details
OS	macOS (Windows/Linux untested)
Runtime	Bun v1.0+
Version Control	Git 2.20+
GitHub CLI	gh
Caddy	caddy (for dev server)

Getting Started

Quick Start (Pre-built)

Download Superset for macOS

Build from Source

Click to expand build instructions

1. Clone the repository

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

2. Set up environment variables (choose one):

Option A: Full setup

cp .env.example .env
# Edit .env and fill in the values

Option B: Skip env validation (for quick local testing)

cp .env.example .env
echo 'SKIP_ENV_VALIDATION=1' >> .env

3. Set up Caddy (reverse proxy for Electric SQL streams):

# Install caddy: brew install caddy (macOS) or see https://caddyserver.com/docs/install
cp Caddyfile.example Caddyfile

# Without this, Chromium rejects https://localhost:* with ERR_CERT_AUTHORITY_INVALID.
# Prompts for sudo once.
caddy trust

4. Install dependencies and run

bun install
bun run dev

5. Build the desktop app

bun run build
open apps/desktop/release

Keyboard Shortcuts

All shortcuts are customizable via Settings > Keyboard Shortcuts (⌘/). See full documentation.

Popularity

What's Inside

README

The Code Editor for AI Agents

Code 10x Faster With No Switching Cost

Features

Supported Agents

Requirements

Getting Started

Quick Start (Pre-built)

Build from Source

Keyboard Shortcuts

Workspace Navigation

Confidence

Similar Plugins

ecc

claude-hud

octo

claude-md-management

uitkit

feature-dev

More by younghai

superpowers

oh-my-claudecode

everything-claude-code

mmk-cardnews

coding-tutor

Popularity

Health & Quality

More by younghai

superpowers

oh-my-claudecode

everything-claude-code

mmk-cardnews

coding-tutor

Similar Plugins

ecc

claude-hud

octo

claude-md-management

uitkit

feature-dev