# Superset Superset is a desktop code editor purpose-built to orchestrate multiple AI coding agents in parallel. It positions itself as "the code editor for AI agents"; each task runs in its own [[Git Worktree]] so agents can work simultaneously on the same repo without stepping on each other. Available as a desktop IDE, a CLI, and an [[Model Context Protocol (MCP)]] server. Not to be confused with Apache Superset (the open-source BI / data exploration tool) — different product, different domain. This one lives at superset.sh and is maintained by superset-sh on GitHub. Source-available under the **Elastic License 2.0 (ELv2)**, not OSI-approved open source. The marketing copy says "open source"; the license is permissive for end users but restricts hosted-as-a-service redistribution. ## The problem it solves Running one coding agent ([[Claude Code]], [[Cursor.com]], [[OpenCode]], [[Gemini CLI]], [[Codex CLI]]) on a repo is straightforward. Running *several in parallel* falls apart on shared filesystem state, branch collisions, and stash/checkout dance. Superset's bet: give each agent task its own worktree, expose them all in one IDE, and the parallelism becomes ordinary. Adjacent to [[Scion]] (Google's multi-agent orchestration testbed — containers + worktrees, terminal-native) but with a *desktop IDE* as the primary surface instead of tmux. ## Key features - **Parallel agent execution.** 10+ coding agents at once, each in an isolated worktree. - **Harness-agnostic.** Works with any CLI-based coding agent — [[Claude Code]], [[OpenCode]], [[Cursor CLI]], [[Gemini CLI]], [[OpenAI Codex|Codex]], and others. - **Workspace per branch.** Each branch is its own workspace; no stashing, no checkout switching. - **Built-in diff viewer.** Stage, review, and commit without leaving the app. - **One-click handoff.** Open any workspace in [[Visual Studio Code (VSCode)]], [[Cursor.com|Cursor]], Xcode, [[JetBrains]], or a terminal of choice. - **Persistent terminal sessions** scoped to each workspace. - **Port management** for multiple dev servers running concurrently. - **In-app browser** for quick inspection without context-switching. - **Remote workspaces** to extend beyond the local machine. - **MCP server mode** so other agents can drive Superset programmatically. - **Local-first.** Functions offline; syncs when connected. ## Tech stack - **Desktop shell:** Electron - **Frontend:** React + TailwindCSS - **Runtime / package manager:** [[Bun]] - **Build:** Turborepo + Vite - **Backend:** [[tRPC]], Drizzle ORM, Neon - **Code quality:** Biome - **Language:** [[TypeScript]] ## Availability - macOS (Apple Silicon and Intel) — current - Windows and Linux — planned Three distribution shapes: desktop IDE, CLI, and MCP server — pick whichever surface fits the workflow. ## Install ```sh # Pre-built (macOS): download from https://superset.sh/ # From source git clone https://github.com/superset-sh/superset cd superset bun install bun run dev ``` ## Where it fits Superset is the **IDE-shaped slot** in the parallel-agent stack. The category is crystallizing fast in 2026: - [[Scion]] — terminal-native, container-isolated, multi-machine via Hub. Apache 2.0. - **Superset** — desktop IDE, worktree-isolated, single-machine focus. ELv2. - [[Claude Code Auto Mode]] / [[Claude Code Channels]] — first-party Anthropic primitives for parallel work, single harness. Different surfaces, same wager: serious agentic work is multi-agent, and isolation is a first-class primitive — not an afterthought. ## License caveat ELv2 lets users run, modify, and redistribute the software, but bans (a) offering it as a hosted/managed service that competes with Superset, and (b) circumventing the license/feature gating. For internal team use, it's effectively open. For "I want to fork this and run a competing SaaS," it's not. This pattern — calling source-available licenses "open source" in marketing — is now common (Elastic, MongoDB, Redis, Sentry). The vault note for the project should always state the actual license. ## References - Official website: <https://superset.sh/> - Documentation: <https://docs.superset.sh/overview> - Source code: <https://github.com/superset-sh/superset> - Blog: <https://superset.sh/blog> - Changelog: <https://superset.sh/changelog> - Community: <https://superset.sh/community> - Team: <https://superset.sh/team> - License: Elastic License 2.0 (ELv2) ## Related - [[AI Agent Harness]] - [[AI Agent Orchestration]] - [[AI Agents]] - [[AI Subagents]] - [[Claude Code]] - [[Cursor.com]] - [[OpenCode]] - [[Gemini CLI]] - [[Codex CLI]] - [[OpenAI Codex]] - [[Cline]] - [[Roo Code]] - [[Aider]] - [[Scion]] — terminal-native equivalent (containers + worktrees, multi-machine) - [[Git Worktree]] - [[Model Context Protocol (MCP)]] - [[Bun]] - [[TypeScript]] - [[React]] - [[Agent Client Protocol (ACP)]] - [[Harness Engineering]]