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 Droid Fully supported Gemini CLI Fully supported GitHub Copilot Fully supported Mastra Code Fully supported OpenCode Fully supported 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:
git clone https://github.com/superset-sh/superset.git cd superset ./.superset/setup.local.sh bun run dev
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
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).
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.
⌘/
Workspace Navigation
Shortcut Action ⌘1-9 Switch to workspace 1-9 ⌘⌥↑/↓ Previous/next workspace ⌘N New workspace ⌘⇧N Quick create workspace ⌘⇧O Open project
⌘1-9
⌘⌥↑/↓
⌘N
⌘⇧N
⌘⇧O
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
⌘T
⌘W
⌘D
⌘⇧D
⌘K
⌘F
⌘⌥←/→
Ctrl+1-9
Layout
Shortcut Action ⌘B Toggle workspaces sidebar ⌘L Toggle changes panel ⌘O Open in external app ⌘⇧C Copy path
⌘B
⌘L
⌘O
⌘⇧C
Configuration
Configure workspace setup and teardown in .superset/config.json. See full documentation.
Option Type Description setup string[] Commands to run when creating a workspace teardown string[] Commands to run when deleting a workspace
setup
string[]
teardown
string[]
Example setup script
#!/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_WORKSPACE_NAME
SUPERSET_ROOT_PATH — Path to the main repository
SUPERSET_ROOT_PATH
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.
mastracode
@mastra/*
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.
Contributing
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)
git checkout -b feature/amazing-feature
Commit your changes (git commit -m 'Add amazing feature')
git commit -m 'Add amazing feature'
Push to the branch (git push origin feature/amazing-feature)
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.
Community
Join the Superset community to get help, share feedback, and connect with other users:
Discord — Chat with the team and community
Twitter — Follow for updates and announcements
GitHub Issues — Report bugs and request features
GitHub Discussions — Ask questions and share ideas
Team
License
Distributed under the Elastic License 2.0 (ELv2). See LICENSE.md for more information.
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 Droid Fully supported Gemini CLI Fully supported GitHub Copilot Fully supported Mastra Code Fully supported OpenCode Fully supported 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:
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).
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.
⌘/
Workspace Navigation
Shortcut Action ⌘1-9 Switch to workspace 1-9 ⌘⌥↑/↓ Previous/next workspace ⌘N New workspace ⌘⇧N Quick create workspace ⌘⇧O Open project
⌘1-9
⌘⌥↑/↓
⌘N
⌘⇧N
⌘⇧O
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
⌘T
⌘W
⌘D
⌘⇧D
⌘K
⌘F
⌘⌥←/→
Ctrl+1-9
Layout
Shortcut Action ⌘B Toggle workspaces sidebar ⌘L Toggle changes panel ⌘O Open in external app ⌘⇧C Copy path
⌘B
⌘L
⌘O
⌘⇧C
Configuration
Configure workspace setup and teardown in .superset/config.json. See full documentation.
Option Type Description setup string[] Commands to run when creating a workspace teardown string[] Commands to run when deleting a workspace
setup
string[]
teardown
string[]
Example setup script
#!/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_WORKSPACE_NAME
SUPERSET_ROOT_PATH — Path to the main repository
SUPERSET_ROOT_PATH
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.
mastracode
@mastra/*
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.
Contributing
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)
git checkout -b feature/amazing-feature
Commit your changes (git commit -m 'Add amazing feature')
git commit -m 'Add amazing feature'
Push to the branch (git push origin feature/amazing-feature)
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.
Community
Join the Superset community to get help, share feedback, and connect with other users:
Discord — Chat with the team and community
Twitter — Follow for updates and announcements
GitHub Issues — Report bugs and request features
GitHub Discussions — Ask questions and share ideas
Team
License
Distributed under the Elastic License 2.0 (ELv2). See LICENSE.md for more information.