superset README

The project's README from github.com/superset-sh/superset. As one markdown file: README.md.

Claude and OpenCode working in parallel Superset workspaces with live diffs

Run 100+ Coding Agents in Parallel

🌐 Read this in other languages

English | 日本語 | 简体中文 | 繁體中文 | 한국어 | Français | Español | Deutsch | Português | Italiano | Русский | Türkçe | Polski | Nederlands | Bahasa Indonesia | Čeština | Tiếng Việt

GitHub stars GitHub release License Twitter Discord


Claude Code, Codex, or any CLI agent, each in its own isolated worktree.
Spend your time shipping, not waiting.


Download for macOS  •  Documentation  •  Changelog  •  Discord


Code 10x Faster With No Switching Cost

Superset runs CLI-based coding agents in parallel across isolated git worktrees, with built-in terminal, review, and open-in-editor workflows.

Wait less, ship more.

Features

Parallel Workspaces

Run 100+ 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 →

Claude streaming a billing migration while other agents run in parallel workspaces

Agent Monitoring

Track every agent from the sidebar, with working indicators, completion chimes, and dock badges when one needs your attention.

Docs →

An agent finishing its task and the sidebar status flipping from working to done

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 →

Typing a follow-up with an @-file mention in the rich prompt editor next to a split terminal

Built-in Diff Viewer

Inspect, comment on, and edit agent changes without leaving the app, then commit and push when it's ready.

Docs →

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 →

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 →

Scheduled agent automations

Remote Access

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 →

Hosts and members in organization settings

Superset CLI

Script it from any shell: create workspaces, launch agents, read their terminals, and manage automations with a single binary. If an agent can run a command, it can drive Superset.

Docs →

Creating a workspace and launching an agent from the Superset CLI

Command Palette

Jump to any workspace, action, or setting from one search box.

Docs →

Typing in the command palette and filtering workspace actions live

Also in the box:

Supported Agents

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

Agent Status
Amp Code  Amp Code Fully supported
Antigravity  Antigravity CLI Fully supported
Claude Code  Claude Code Fully supported
OpenAI Codex CLI  OpenAI Codex CLI Fully supported
Cursor Agent  Cursor Agent Fully supported
Droid  Droid Fully supported
fx  fx Fully supported
Gemini CLI  Gemini CLI Fully supported
GitHub Copilot  GitHub Copilot Fully supported
Grok  Grok Fully supported
Hermes  Hermes Fully supported
Kimi Code  Kimi Code Fully supported
Kiro  Kiro Fully supported
Mastra Code  Mastra Code Fully supported
Mistral Vibe  Mistral Vibe Fully supported
Oh My Pi  Oh My Pi Fully supported
OpenCode  OpenCode Fully supported
Pi  Pi Fully supported
Polygraph  Polygraph 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:

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 The full IDE: terminals, diff viewer, in-app browser, automations
CLI A single superset binary to manage workspaces, agents, terminals, and hosts from any shell
TypeScript SDK Drive Superset programmatically with @superset_sh/sdk from Node, Bun, or Deno
MCP Server 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:

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.

Install

Download the desktop app:

All you need installed is Git. gh is optional and unlocks the PR workflows; Superset offers to install it for you.

Development

Want to hack on Superset or contribute a PR? Clone the repository, add it to the installed Superset app, and create a workspace for your change:

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

Then run the development setup from that workspace terminal:

./.superset/setup.local.sh
bun run dev

Run setup.local.sh once in every new worktree. It configures workspace-specific app identity and ports so the development desktop app can run alongside the installed Superset app and other development worktrees.

No Neon account or third-party credentials are 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 [email protected] / supersetdev).

Prereqs: Bun v1.3.14+ (pinned in .bun-version), docker, jq, and caddy, which bun dev runs as the local HTTPS proxy (brew install jq caddy && caddy trust).

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.

Configuration

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

{
  "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.

Tech Stack

Electron React TailwindCSS Bun Turborepo Vite Biome Drizzle ORM Neon tRPC

Private by Default

Contributing

We welcome contributions! See CONTRIBUTING.md for how to get set up and open a PR. Bugs and feature requests go in issues.

Community

Join the Superset community to get help, share feedback, and connect with other users:

superset (superset-sh/superset)

Searching Database…

15.4K ·GitHub
这是什么?Superset 是一款智能桌面 IDE,可以并行运行 100 多个命令行编码代理,每个代理都在自己隔离的 git worktree 中工作,并内置终端、diff 审查,所有任务都能在一处统一监控。
它只是一个桌面应用,还是也能用其他工具来操作?桌面应用是主要入口,但同样的工作区也可以通过 superset CLI、TypeScript SDK 以及一个 MCP 服务器来访问,MCP 服务器能让代理自己创建和管理工作区。
我该怎么把它跑起来?下载桌面应用——macOS 版 .dmg(支持 Apple Silicon 或 Intel)或实验性的 Linux x64 AppImage——并确保已安装 Git。gh 是可选的,装上之后可以解锁 PR 相关的工作流程。
我能在里面运行哪些编码代理?任何基于命令行的代理都行:Claude Code、OpenAI Codex CLI、Cursor Agent、Gemini CLI、GitHub Copilot、OpenCode、Amp、Droid、Grok、Hermes 等等——而且其他任何终端代理无需配置即可直接使用。
它支持 Windows 吗?暂时不支持。macOS 是主要目标平台,Linux 以实验性的 x64 AppImage 形式提供,目前没有 Windows 版本。
我的代码或数据会传到 Superset 的服务器上吗?默认是私有的:除非你明确选择要连接哪些代理、服务商和集成,否则什么都不会外传。
它是开源的吗?它是源码可见(source-available)而不是真正的开源:完整源码托管在 GitHub 上,采用 Elastic License 2.0(ELv2)许可。
为什么每个任务都有自己独立的 git worktree?每个代理都在一个隔离的 worktree 中运行,拥有自己的分支、终端和环境,因此并行运行的代理之间不会互相干扰——你只需对比结果,然后合并最满意的那一个。
不离开这个应用,我能对代理的改动做些什么?你可以在内置的 diff 查看器里查看、评论和编辑这些改动,准备好后直接提交并推送——还能一键把工作区交给 Cursor、VS Code 或任何编辑器继续处理。
它能自己搞定那些重复性的琐事吗?可以——Automations 能按计划定时运行代理会话,比如在夜里分拣 issue、起草每周更新日志,或者保持依赖版本最新。
我离开电脑后还能查看代理的运行情况吗?可以——Remote Access 让你通过桌面应用、CLI 或手机访问某台机器上的工作区,对离线的主机还能发送唤醒命令。iOS 应用也即将推出。
Size
739.7 MB
Stars
15.4K
Age
11mo
Commits · 90 Days