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

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.

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

If it runs in a terminal, it runs on Superset

Download Superset for macOS

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

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

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

# 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

bun install
bun run dev

bun run build
open apps/desktop/release

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

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

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

#!/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

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:

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. 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:

• 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

Distributed under the Elastic License 2.0 (ELv2). See LICENSE.md for more information.