Superset:并行编排 100+ 编码代理的 Agentic IDE
Superset 是一个面向 CLI 编码代理的 Agentic IDE,可在相互隔离的 git worktree 中并行运行 100+ 个编码代理,内置终端、Diff 评审、应用内浏览器与端口预览、定时自动化、远程主机访问、CLI/TypeScript SDK/MCP 等多种入口。桌面端永久免费,源码以 Elastic License 2.0 开源,可用自己的订阅运行任意终端代理。
社区作者 · zZz
它解决什么问题
Superset 的核心定位是「用并行替代等待」:把每个编码任务放进独立的 git worktree(各自拥有分支、终端和环境),从而可以同时跑多个 CLI 代理而互不干扰,最后对比结果、合并胜出的那份。
主要能力:
- 并行工作区(Parallel Workspaces):一次运行 100+ 编码代理,每个代理独占 worktree、分支、终端与环境。
- 代理监控(Agent Monitoring):侧边栏跟踪每个代理状态,含 working 指示、完成提示音,以及在需要你介入时显示 Dock 角标(见配图 3)。
- 内置终端(Built-in Terminal):支持标签页、无限分屏、预设与重启后仍存活的持久会话;按 ⌘I 打开富提示词编辑器,支持多行编辑与 @-file 引用(见配图 1、配图 2、配图 4)。
- 内置 Diff 查看器(Built-in Diff Viewer):在应用内查看、评论、编辑代理改动,确认后就地 commit 与 push(见配图 5)。
- 应用内浏览器与端口(In-App Browser & Ports):在浏览器面板预览运行中的 dev server,端口按工作区自动检测,每个 worktree 都有自己的预览(见配图 6)。
- 自动化(Automations):按计划运行代理会话,例如夜间处理 issue 分流、起草每周 changelog、保持依赖更新(见配图 7)。
- 远程访问(Remote Access):连接另一台机器并从任意位置访问其工作区,入口包括桌面应用、CLI 或手机;可用自定义命令唤醒离线主机(见配图 8)。
- Superset CLI:单一二进制即可创建工作区、启动代理、读取终端输出、管理自动化;只要代理能执行命令,就能驱动 Superset(见配图 9)。
- 命令面板(Command Palette):一个搜索框跳转到任意工作区、操作或设置(见配图 10)。
- 其他内置能力:内置 skills(代理启动时自动装配 superset:* skills,用于编排并行代理、调度自动化、提交反馈、诊断问题);模型选择器与自定义代理(启动时选择模型与推理强度,可添加任意终端代理并配独立图标,见配图 11、配图 12);工作区 setup 脚本(自动完成环境初始化、依赖安装与 dev server 启动);终端预设(保存代理与 shell 布局,一键打开);Slack 与 Linear 集成(从 Slack 消息或 Linear issue 直接拉起工作区);一键在 Cursor、VS Code 或任意编辑器中打开;自定义主题(创建、编辑、导入主题文件);键盘快捷键(设置 → Keyboard Shortcuts(⌘/)可重映射所有操作);自带 provider(可接入 OpenRouter、Bedrock、Vertex 或 Vercel AI Gateway)。
多种入口共用同一批工作区:桌面应用提供完整 IDE(终端、Diff 查看器、应用内浏览器、自动化);CLI 提供单个 superset 二进制管理 worktree、代理、终端与主机;TypeScript SDK 提供 @superset_sh/sdk,可在 Node、Bun 或 Deno 中编程驱动 Superset;MCP Server 让 Claude Code、Codex、Cursor 等代理自行创建和管理工作区。CLI 随桌面应用捆绑,也可独立安装。iOS 应用正在开发中。
隐私与开源:默认私有,全量源码在 GitHub 上以 Elastic License 2.0(ELv2)发布;代理、provider 与集成都由用户显式选择连接。桌面应用永久免费,在自己机器上并行运行代理永远不会收费,付费内容只会是可选的附加服务。源码可用于使用、fork、修改以及团队自托管,唯一限制是不能把 Superset 本身重新打包成对外售卖的服务。
— 本文由 AI 根据公开来源辅助整理,命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
【一、安装桌面应用(普通用户)】
步骤 1 · 前置依赖:只需要安装 Git。
gh 为可选项,安装后可解锁 PR 相关流程,Superset 会主动询问是否代为安装。
- 下载对应平台安装包:
- macOS:Apple Silicon (.dmg) · Intel (.dmg),macOS 是官方主要支持目标。
- Linux:x64 AppImage(experimental,实验性支持)。
- Windows:暂不可用(not yet available)。
- 其他:All builds(全部构建版本)页面。
- 页面同时提供 Documentation、Changelog、Discord 入口,可查阅文档与更新日志。
【二、安装 CLI(可独立安装,CLI 也已随桌面应用捆绑)】 方式 A(脚本安装):
curl -fsSL https://superset.sh/cli/install.sh | sh方式 B(Homebrew):
brew install superset-sh/tap/superset安装后可用单个 superset 二进制管理 worktree、代理、终端与主机,建设工作区、启动代理、读取终端输出并管理自动化。
【三、从源码开发(贡献者/自行构建)】
- 克隆仓库:
git clone https://github.com/superset-sh/superset.git- 把仓库添加到已安装的 Superset 应用中,并为你的改动创建一个工作区。
- 在该工作区终端中运行开发初始化脚本:
./.superset/setup.local.shbun run dev注意:每个新 worktree 都要运行一次 setup.local.sh。它会配置该工作区专属的应用标识与端口,使开发版桌面应用能与已安装的 Superset 应用以及其他开发 worktree 同时运行。
步骤 4 · 开发前置依赖(Prereqs):
Bun v1.3.14+(版本固定在 .bun-version 文件中)、docker、jq、caddy;caddy 由 bun dev 作为本地 HTTPS 代理运行。安装示例:
brew install jq caddy && caddy trust- 首次运行与登录:不需要 Neon 账号或任何第三方凭据。setup.local.sh 会通过 Docker 启动本地 Postgres + Electric 技术栈,并播种一个开发账号。点击 "Sign in as dev" 按钮登录,或使用 [email protected] / supersetdev。
- 完整开发指南见 DEVELOPMENT.md,其中包含:setup 脚本做了什么、如何对照真实服务手动配置、常用命令、故障排查、以及如何构建桌面应用。贡献流程见 CONTRIBUTING.md。
【四、工作区配置】 在 .superset/config.json 中配置工作区的 setup、teardown 与 run 脚本(完整文档见官方文档),示例: { "setup": ["./.superset/setup.sh"], "teardown": ["./.superset/teardown.sh"], "run": ["./.superset/run.sh"] } 键盘快捷键可在 设置 → Keyboard Shortcuts(⌘/)中自定义,完整快捷键列表见官方文档。
【五、常见问题与注意事项】
- 只安装 Git 即可使用;未安装 gh 时 PR 工作流不可用,但 Superset 会提示帮你安装。
- Linux 版本标注为实验性;Windows 版尚未提供。
- 每个新 worktree 都必须重新执行一次 ./.superset/setup.local.sh,否则开发版应用可能与已安装版本端口/标识冲突。
- 本地开发依赖 Docker 拉起 Postgres + Electric,未安装 docker 会导致初始化失败。
- 快捷键、代理启动命令、提示词模板、模型覆盖等可在 设置 → Agents 中按代理调整。