Orchestrate swarms of Claude Code, Codex, and more in parallel.
Works with any CLI agent. Built for local worktree-based development.
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 overheadIsolate each task in its own git worktree so agents don't interfere with each otherMonitor all your agents from one place and get notified when they need attentionReview and edit changes quickly with the built-in diff viewer and editorOpen any workspace where you need it with one-click handoff to your editor or terminal
Wait less, ship more.
| 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 |
Superset works with any CLI-based coding agent, including:
| Agent | Status |
|---|---|
Claude CodeOpenAI Codex CLICursor AgentGemini CLIGitHub CopilotOpenCodePiIf it runs in a terminal, it runs on Superset
| Requirement | Details |
|---|---|
| OS | |
| macOS (Windows/Linux untested) | |
| Runtime | |
Version Control****GitHub CLIgh** Caddy**caddy(for dev server)## 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
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):
cp Caddyfile.example Caddyfile
caddy trust
4. Install dependencies and run
bun install
bun run dev
5. Build the desktop app
bun run build
open apps/desktop/release
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 |
| 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 |
| Shortcut | Action |
|---|---|
⌘B |
|
| Toggle workspaces sidebar | |
⌘L |
|
| Toggle changes panel | |
⌘O |
|
| Open in external app | |
⌘⇧C |
|
| Copy path |
Configure workspace setup and teardown in .superset/config.json
. See full documentation.
{
"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 |
#!/bin/bash
cp ../.env .env
bun install
echo "Workspace ready!"
Scripts have access to environment variables:
SUPERSET_WORKSPACE_NAME
— Name of the workspaceSUPERSET_ROOT_PATH
— Path to the main repository
This repo uses the published upstream mastracode
and @mastra/*
packages directly. Avoid adding custom tarball overrides unless there is a repo-specific blocker.
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.
We welcome contributions! If you have a suggestion that would make Superset better:
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature
) - Commit your changes (
git commit -m 'Add amazing feature'
) - Push to the branch (
git push origin feature/amazing-feature
) - Open a Pull Request
You can also open issues for bugs or feature requests.
See CONTRIBUTING.md for detailed instructions and code of conduct.
Join the Superset community to get help, share feedback, and connect with other users:
— Chat with the team and communityDiscord— Follow for updates and announcementsTwitter— Report bugs and request featuresGitHub Issues— Ask questions and share ideasGitHub Discussions
Distributed under the Elastic License 2.0 (ELv2). See LICENSE.md for more information.