Superset:并行运行 100+ 个编程 Agent
英文标题:📦 superset-sh/superset
Superset 是一款面向 CLI 编程 Agent 的桌面与命令行工作区管理工具,可在隔离的 Git worktree 中并行运行 100 多个 Agent,包括 Claude Code、Codex 等。它集成终端、Diff 审查、浏览器预览、自动化调度、远程工作区、CLI、TypeScript SDK 与 MCP Server,并允许开发者自带模型订阅或连接 OpenRouter、Bedrock、Vertex 等提供商。对开发者而言,该工具旨在减少多任务 Agent 协作中的上下文切换与环境冲突,并支持从本地应用、终端或远程设备统一管理任务。桌面应用永久免费,本机并行运行 Agent 不收费;项目源代码以 Elastic License 2.0(ELv2)提供。
9.1 MB
687.1 KB
101.0 KB
401.6 KB
193.4 KB
133.4 KB
117.9 KB
278.5 KB
119.8 KB
266.9 KB
中文
无切换成本,编码速度提升 10 倍
Superset 可在隔离的 Git worktree 中并行运行基于 CLI 的编程 Agent,并内置终端、审查和在编辑器中打开等工作流。
- 同时运行多个 Agent,无需承担上下文切换开销
- 隔离每项任务:每项任务各自位于一个 Git worktree 中,Agent 之间互不干扰
- 在一处监控所有 Agent,并在它们需要关注时获得通知
- 借助内置 Diff 查看器和编辑器,快速审查和修改变更
- 通过一键交接至编辑器或终端,在所需位置打开任意工作区
- 通过远程主机、CLI、SDK 或 MCP,随时随地访问工作区
少等待,多交付。
| 一次运行 100+ 个编程 Agent;每个 Agent 都拥有独立的 Git worktree、分支、终端和环境。比较结果并合并胜出方案。文档 → | ![]() |
| 从侧边栏跟踪每个 Agent,查看工作状态指示、完成提示音,以及需要你关注时显示的 Dock 徽标。文档 → | ![]() |
支持标签页、无限分屏、预设和重启后仍可保留的持久会话。按下 ⌘I 可打开富文本提示编辑器,支持多行编辑和 @ 文件提及。文档 → |
![]() |
| 无需离开应用即可检查、评论和编辑 Agent 的变更,准备就绪后再提交并推送。文档 → | ![]() |
| 在浏览器面板中预览正在运行的开发服务器。系统会按工作区检测端口,因此每个 worktree 都拥有自己的预览。文档 → | ![]() |
| 按计划运行 Agent 会话:夜间分流处理 issue、起草每周更新日志、保持依赖项更新。文档 → | ![]() |
| 连接另一台机器后,可从任何地方访问其工作区:桌面应用、CLI 或手机均可。还可使用自定义命令唤醒离线主机。文档 → | ![]() |
| 可通过任意 Shell 编写脚本:使用单个二进制文件创建工作区、启动 Agent、读取其终端并管理自动化任务。只要 Agent 能运行命令,它就能驱动 Superset。文档 → | ![]() |
| 通过一个搜索框跳转至任意工作区、操作或设置。文档 → | ![]() |
还包括:
- 内置技能:Agent 预装
superset:*技能(编排并行 Agent、安排自动化任务、提交反馈、诊断问题),并会在启动时自动配置 - 模型选择器与自定义 Agent:启动时选择模型和推理强度,并可添加带有独立图标的任意终端 Agent
- 工作区设置脚本:自动完成每个工作区的环境设置、依赖安装和开发服务器启动
- 终端预设:保存 Agent 和 Shell 布局,并通过一次按键打开
- Slack 与 Linear:从 Slack 消息或 Linear issue 创建工作区
- 在你的 IDE 中打开:一键交接至 Cursor、VS Code 或任意编辑器
- 自定义主题:创建、编辑和导入主题文件
- 键盘快捷键:可通过 设置 → 键盘快捷键(⌘/)重新映射每项操作
- 自带提供商:连接 OpenRouter、Bedrock、Vertex 或 Vercel AI Gateway
- 以及更多功能:我们每天都在发布更新,因此这份列表始终会滞后;更新日志才是真正的功能列表。
Superset 可与任何基于 CLI 的编程 Agent 配合使用,包括:
只要能在终端中运行,就能在 Superset 上运行。
Agent 获得的不只是一个终端:
- 模型选择器:启动 Agent 时选择模型和推理强度
- 单 Agent 设置:在“设置 → Agents”中调整启动命令、提示模板和模型覆盖项
- 自定义 Agent:添加带有独立图标的任意终端 Agent,它会像内置 Agent 一样工作
- 状态与通知:当 Agent 需要你关注时,提供工作状态指示、完成提示音和 Dock 徽标
- 内置聊天:在聊天面板中与模型对话,支持内联工具审批和计划审查
所有入口都连接至同一批工作区,因此你可以在应用中启动任务,再从任何地方查看其状态。
| 入口 | 你将获得的功能 |
|---|---|
| 桌面应用 | 完整 IDE:终端、Diff 查看器、应用内浏览器、自动化功能 |
| CLI | 一个 superset 二进制文件,可通过任意 Shell 管理工作区、Agent、终端和主机 |
| TypeScript SDK | 可从 Node、Bun 或 Deno 使用 @superset_sh/sdk 以编程方式驱动 Superset |
| MCP Server | 让 Claude Code、Codex、Cursor 和其他 Agent 自行创建及管理工作区 |
CLI 随桌面应用一同提供,也可单独安装:
curl -fsSL https://superset.sh/cli/install.sh | sh
# or
brew install superset-sh/tap/superset
iOS 应用即将推出,届时你可通过手机查看 Agent 状态。
下载桌面应用:
你只需安装 Git。gh 为可选项,可解锁 PR 工作流;Superset 会提示你安装它。
想要开发 Superset 或贡献 PR?克隆仓库,将其添加至已安装的 Superset 应用,并为你的变更创建一个工作区:
git clone https://github.com/superset-sh/superset.git
然后在该工作区终端中运行开发环境设置:
./.superset/setup.local.sh
bun run dev
在每个新的 worktree 中运行一次 setup.local.sh。该脚本会配置工作区专属的应用标识和端口,以便开发版桌面应用可与已安装的 Superset 应用及其他开发 worktree 同时运行。
无需 Neon 账户或第三方凭据。setup.local.sh 会通过 Docker 启动本地 Postgres + Electric 堆栈,并创建一个开发账户。点击 “Sign in as dev” 按钮(或使用 admin@local.test / supersetdev)登录。
前置要求:Bun v1.3.14+(固定于 .bun-version)、docker、jq 和 caddy;bun dev 会将 caddy 作为本地 HTTPS 代理运行(brew install jq caddy && caddy trust)。
完整指南见 DEVELOPMENT.md:包括设置脚本的工作内容、针对真实服务的手动设置、常用命令、故障排查,以及如何构建桌面应用。贡献流程见 CONTRIBUTING.md。
在 .superset/config.json 中配置工作区的设置、清理和运行脚本。参见完整文档。
{
"setup": ["./.superset/setup.sh"],
"teardown": ["./.superset/teardown.sh"],
"run": ["./.superset/run.sh"]
}
可通过 设置 → 键盘快捷键(⌘/)自定义键盘快捷键;请参阅完整快捷键列表。
English / 原文
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.
- 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.
| 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 → | ![]() |
|---|---|
| Track every agent from the sidebar, with working indicators, completion chimes, and dock badges when one needs your attention. Docs → | ![]() |
| Tabs, infinite splits, presets, and persistent sessions that survive restarts. Press ⌘I for a rich prompt editor with multiline editing and @-file mentions. Docs → | ![]() |
| Inspect, comment on, and edit agent changes without leaving the app, then commit and push when it's ready. Docs → | ![]() |
| Preview running dev servers in a browser pane. Ports are detected per workspace, so every worktree gets its own preview. Docs → | ![]() |
| Run agent sessions on a schedule: triage issues overnight, draft the weekly changelog, keep dependencies fresh. Docs → | ![]() |
| 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 → | ![]() |
| 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 → | ![]() |
| Jump to any workspace, action, or setting from one search box. Docs → | ![]() |
Also in the box:
- Built-in skills : agents come pre-loaded with
superset:*skills (orchestrate parallel agents, schedule automations, file feedback, diagnose issues), provisioned automatically at launch - Model picker& custom agents: choose a model and reasoning effort at launch, and add any terminal agent with its own icon
- Workspace setup scripts : automate env setup, dependency installs, and dev servers per workspace
- Terminal presets : save agent and shell layouts and open them with one keystroke
- Slack& Linear: spin up workspaces from Slack messages or Linear issues
- Open in your IDE : one-click handoff to Cursor, VS Code, or any editor
- Custom themes : build, edit, and import theme files
- Keyboard shortcuts : every action is remappable via Settings → Keyboard Shortcuts (⌘/)
- Bring your own providers : connect OpenRouter, Bedrock, Vertex, or Vercel AI Gateway
- And many more : we ship daily, so this list is perpetually behind. The changelog is the real feature list.
Superset works with any CLI-based coding agent, including:
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
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.
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.
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 admin@local.test / 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.
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.
- Source Available : full source is on GitHub under Elastic License 2.0 (ELv2).
- Explicit Connections : you choose which agents, providers, and integrations to connect.
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:
License & what's free forever
The desktop app is free forever. Running agents in parallel on your own machine will never require payment. Anything we charge for will be an optional service on top.
The whole app is in this repo under the Elastic License 2.0: use it, fork it, modify it, self-host it for your team. The only thing off the table is repackaging Superset itself as a service you sell to others.








