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:
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.
Workspace Navigation
