superset-sh/superset — Gitpedia

The Code Editor for AI Agents

<br />

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

<br />

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
<img height="16" align="top" src="packages/ui/src/assets/icons/preset-icons/amp.svg" /> Amp Code	Fully supported
<img height="16" align="top" src="packages/ui/src/assets/icons/preset-icons/claude.svg" /> Claude Code	Fully supported
<picture><source media="(prefers-color-scheme: dark)" srcset="packages/ui/src/assets/icons/preset-icons/codex-white.svg" /><img height="16" align="top" src="packages/ui/src/assets/icons/preset-icons/codex.svg" /></picture> OpenAI Codex CLI	Fully supported
<img height="16" align="top" src="packages/ui/src/assets/icons/preset-icons/cursor.svg" /> Cursor Agent	Fully supported
<picture><source media="(prefers-color-scheme: dark)" srcset="packages/ui/src/assets/icons/preset-icons/droid-white.svg" /><img height="16" align="top" src="packages/ui/src/assets/icons/preset-icons/droid.svg" /></picture> Droid	Fully supported
<img height="16" align="top" src="packages/ui/src/assets/icons/preset-icons/gemini.svg" /> Gemini CLI	Fully supported
<picture><source media="(prefers-color-scheme: dark)" srcset="packages/ui/src/assets/icons/preset-icons/copilot-white.svg" /><img height="16" align="top" src="packages/ui/src/assets/icons/preset-icons/copilot.svg" /></picture> GitHub Copilot	Fully supported
<picture><source media="(prefers-color-scheme: dark)" srcset="packages/ui/src/assets/icons/preset-icons/mastracode-white.svg" /><img height="16" align="top" src="packages/ui/src/assets/icons/preset-icons/mastracode.svg" /></picture> Mastra Code	Fully supported
<picture><source media="(prefers-color-scheme: dark)" srcset="packages/ui/src/assets/icons/preset-icons/opencode-white.svg" /><img height="16" align="top" src="packages/ui/src/assets/icons/preset-icons/opencode.svg" /></picture> OpenCode	Fully supported
<picture><source media="(prefers-color-scheme: dark)" srcset="packages/ui/src/assets/icons/preset-icons/pi-white.svg" /><img height="16" align="top" src="packages/ui/src/assets/icons/preset-icons/pi.svg" /></picture> Pi	Fully supported
Any other CLI agent	Works without configuration

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)

Install

Download Superset for macOS

Builds for Windows and Linux are not yet available.

Development

Want to hack on Superset or contribute a PR? Spin up a local dev environment in one command:

bash
git clone https://github.com/superset-sh/superset.git
cd superset
./.superset/setup.local.sh
bun run dev

No Neon account or third-party credentials 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, docker, jq, caddy (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.

Keyboard Shortcuts

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

Shortcut	Action
`⌘1-9`	Switch to workspace 1-9
`⌘⌥↑/↓`	Previous/next workspace
`⌘N`	New workspace
`⌘⇧N`	Quick create workspace
`⌘⇧O`	Open project

Terminal

Shortcut	Action
`⌘T`	New tab
`⌘W`	Close pane/terminal
`⌘D`	Split right
`⌘⇧D`	Split down
`⌘K`	Clear terminal
`⌘F`	Find in terminal
`⌘⌥←/→`	Previous/next tab
`Ctrl+1-9`	Open preset 1-9

Layout

Shortcut	Action
`⌘B`	Toggle workspaces sidebar
`⌘L`	Toggle changes panel
`⌘O`	Open in external app
`⌘⇧C`	Copy path

Configuration

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

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

Option	Type	Description
`setup`	`string[]`	Commands to run when creating a workspace
`teardown`	`string[]`	Commands to run when deleting a workspace

Example setup script

bash
#!/bin/bash
# .superset/setup.sh

# Copy environment variables
cp ../.env .env

# Install dependencies
bun install

# Run any other setup tasks
echo "Workspace ready!"

Scripts have access to environment variables:

SUPERSET_WORKSPACE_NAME — Name of the workspace
SUPERSET_ROOT_PATH — Path to the main repository

Mastra Dependencies

This repo uses the published upstream mastracode and @mastra/* packages directly. Avoid adding custom tarball overrides unless there is a repo-specific blocker.

Tech Stack

Private by Default

Source Available — Full source is available on GitHub under Elastic License 2.0 (ELv2).
Explicit Connections — You choose which agents, providers, and integrations to connect.