Superset ### The Code Editor for AI Agents [![GitHub stars](https://img.shields.io/github/stars/superset-sh/superset?style=flat&logo=github)](https://github.com/superset-sh/superset/stargazers) [![GitHub release](https://img.shields.io/github/v/release/superset-sh/superset?style=flat&logo=github)](https://github.com/superset-sh/superset/releases) [![License](https://img.shields.io/github/license/superset-sh/superset?style=flat)](LICENSE.md) [![Twitter](https://img.shields.io/badge/@superset__sh-555?logo=x)](https://x.com/superset_sh) [![Discord](https://img.shields.io/badge/Discord-555?logo=discord)](https://discord.gg/cZeD9WYcV7)
Orchestrate swarms of Claude Code, Codex, and more in parallel.
Works with any CLI agent. Built for local worktree-based development.
[**Download for macOS**](https://github.com/superset-sh/superset/releases/latest)  •  [Documentation](https://docs.superset.sh)  •  [Changelog](https://github.com/superset-sh/superset/releases)  •  [Discord](https://discord.gg/cZeD9WYcV7)
## 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 - **Reach your workspaces from anywhere** via remote hosts, the CLI, the SDK, or MCP Wait less, ship more. ## Features
### Parallel Workspaces Run 10+ coding agents at once, each in its own git worktree with its own branch, terminal, and environment. Compare the results and merge the winner. [Docs →](https://docs.superset.sh/workspaces) Superset sidebar with multiple workspaces running agents in parallel
### Agent Monitoring Track every agent from the sidebar, with working indicators, completion chimes, and dock badges when one needs your attention. [Docs →](https://docs.superset.sh/agent-integration) Agent status indicators in the workspace sidebar
### Built-in Terminal Tabs, infinite splits, presets, and persistent sessions that survive restarts. Press ⌘I for a rich prompt editor with multiline editing and @-file mentions. [Docs →](https://docs.superset.sh/terminal-integration) Split terminals running agents side by side
### Built-in Diff Viewer Inspect, comment on, and edit agent changes without leaving the app, then commit and push when it's ready. [Docs →](https://docs.superset.sh/diff-viewer) Reviewing an agent's changes in the diff viewer
### In-App Browser & Ports Preview running dev servers in a browser pane. Ports are detected per workspace, so every worktree gets its own preview. [Docs →](https://docs.superset.sh/browser) In-app browser previewing a dev server with detected ports
### Automations Run agent sessions on a schedule: triage issues overnight, draft the weekly changelog, keep dependencies fresh. [Docs →](https://docs.superset.sh/automations) Scheduled agent automations
### Remote Workspaces Connect another machine and reach its workspaces from anywhere: the desktop app, the CLI, or your phone. Wake offline hosts with a custom command. [Docs →](https://docs.superset.sh/remote-workspaces) Hosts and members in organization settings
### Command Palette Jump to any workspace, action, or setting from one search box. [Docs →](https://docs.superset.sh/keyboard-shortcuts) Command palette searching across workspaces and actions
**Also in the box:** - **[Model picker & custom agents](https://docs.superset.sh/agent-integration)**: choose a model and reasoning effort at launch, and add any terminal agent with its own icon - **[Workspace setup scripts](https://docs.superset.sh/setup-teardown-scripts)**: automate env setup, dependency installs, and dev servers per workspace - **[Terminal presets](https://docs.superset.sh/terminal-presets)**: save agent and shell layouts and open them with one keystroke - **[Slack & Linear](https://docs.superset.sh/use-with-linear)**: spin up workspaces from Slack messages or Linear issues - **[Open in your IDE](https://docs.superset.sh/use-with-ide)**: one-click handoff to Cursor, VS Code, or any editor - **[Custom themes](https://docs.superset.sh/custom-themes)**: build, edit, and import theme files - **[Keyboard shortcuts](https://docs.superset.sh/keyboard-shortcuts)**: every action is remappable via **Settings → Keyboard Shortcuts** (⌘/) - **[Bring your own providers](https://docs.superset.sh/providers)**: connect OpenRouter, Bedrock, Vertex, or Vercel AI Gateway - **And many more**: we ship daily, so this list is perpetually behind. The [changelog](https://superset.sh/changelog) is the real feature list. ## Supported Agents Superset works with any CLI-based coding agent, including: | Agent | Status | |:------|:-------| | Amp Code  [Amp Code](https://ampcode.com/) | Fully supported | | Claude Code  [Claude Code](https://github.com/anthropics/claude-code) | Fully supported | | OpenAI Codex CLI  [OpenAI Codex CLI](https://github.com/openai/codex) | Fully supported | | Cursor Agent  [Cursor Agent](https://docs.cursor.com/agent) | Fully supported | | Droid  [Droid](https://www.factory.ai/) | Fully supported | | Gemini CLI  [Gemini CLI](https://github.com/google-gemini/gemini-cli) | Fully supported | | GitHub Copilot  [GitHub Copilot](https://github.com/features/copilot) | Fully supported | | Mastra Code  [Mastra Code](https://mastra.ai/) | Fully supported | | Mistral Vibe  [Mistral Vibe](https://mistral.ai/) | Fully supported | | OpenCode  [OpenCode](https://github.com/opencode-ai/opencode) | Fully supported | | Pi  [Pi](https://github.com/badlogic/pi-mono/tree/main/packages/coding-agent) | Fully supported | | Polygraph  [Polygraph](https://trypolygraph.com/) | Fully supported | | Any other CLI agent | Works without configuration | If it runs in a terminal, it runs on Superset Agents get more than a terminal: - **Model picker**: choose a model and reasoning effort when you launch an agent - **Per-agent settings**: tune launch commands, prompt templates, and model overrides in Settings → Agents - **Custom agents**: add any terminal agent with its own icon and it works like a built-in - **Status and notifications**: working indicators, completion chimes, and dock badges when an agent needs you - **Built-in chat**: talk to models in a chat pane, with inline tool approvals and plan review ## More Than a Desktop App Every surface talks to the same workspaces, so you can start a task in the app and check on it from anywhere. | Surface | What you get | |:--------|:-------------| | [**Desktop App**](https://github.com/superset-sh/superset/releases/latest) | The full IDE: terminals, diff viewer, in-app browser, automations | | [**CLI**](https://docs.superset.sh/cli/getting-started) | A single `superset` binary to manage workspaces, agents, terminals, and hosts from any shell | | [**TypeScript SDK**](https://docs.superset.sh/sdk/getting-started) | Drive Superset programmatically with [`@superset_sh/sdk`](https://www.npmjs.com/package/@superset_sh/sdk) from Node, Bun, or Deno | | [**MCP Server**](https://docs.superset.sh/mcp) | Let Claude Code, Codex, Cursor, and other agents create and manage workspaces themselves | The CLI comes bundled with the desktop app, or install it standalone: ```bash curl -fsSL https://superset.sh/cli/install.sh | sh # or brew install superset-sh/tap/superset ``` An iOS app is coming soon so you can check on your agents from your phone. ## Requirements | Requirement | Details | |:------------|:--------| | **OS** | macOS (Windows/Linux untested) | | **Runtime** | [Bun](https://bun.sh/) v1.0+ | | **Version Control** | Git 2.20+ | | **GitHub CLI** | [gh](https://cli.github.com/) | | **Caddy** | [caddy](https://caddyserver.com/docs/install) (for dev server) | ## Install **[Download Superset for macOS](https://github.com/superset-sh/superset/releases/latest)** 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**](./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**](./CONTRIBUTING.md). ## Configuration Configure workspace setup, teardown, and run scripts in `.superset/config.json`. See [full documentation](https://docs.superset.sh/setup-teardown-scripts). ```json { "setup": ["./.superset/setup.sh"], "teardown": ["./.superset/teardown.sh"], "run": ["./.superset/run.sh"] } ``` Keyboard shortcuts are customizable via **Settings → Keyboard Shortcuts** (⌘/); see the [full shortcut list](https://docs.superset.sh/keyboard-shortcuts). ## Tech Stack

Electron React TailwindCSS Bun Turborepo Vite Biome Drizzle ORM Neon tRPC

## Private by Default - **Source Available**: full source is on GitHub under Elastic License 2.0 (ELv2). - **Explicit Connections**: you choose which agents, providers, and integrations to connect. ## Contributing We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for how to get set up and open a PR. Bugs and feature requests go in [issues](https://github.com/superset-sh/superset/issues). ## Community Join the Superset community to get help, share feedback, and connect with other users: - **[Discord](https://discord.gg/cZeD9WYcV7)**: chat with the team and community - **[Twitter](https://x.com/superset_sh)**: follow for updates and announcements - **[GitHub Issues](https://github.com/superset-sh/superset/issues)**: report bugs and request features - **[GitHub Discussions](https://github.com/superset-sh/superset/discussions)**: ask questions and share ideas ### Team [![Avi Twitter](https://img.shields.io/badge/Avi-@avimakesrobots-555?logo=x)](https://x.com/avimakesrobots) [![Kiet Twitter](https://img.shields.io/badge/Kiet-@flyakiet-555?logo=x)](https://x.com/flyakiet) [![Satya Twitter](https://img.shields.io/badge/Satya-@saddle__paddle-555?logo=x)](https://x.com/saddle_paddle) ## License Distributed under the Elastic License 2.0 (ELv2). See [LICENSE.md](LICENSE.md) for more information.