面向 AI 代理的代码编辑器

并行编排 Claude Code、Codex 等多个代理。
兼容任何基于命令行的代理。专为本地工作树开发而设计。

下载 macOS 版本  •  文档  •  更新日志  •  Discord

无切换成本，编码效率提升 10 倍

Superset 可在隔离的 Git 工作树中编排基于命令行的编码代理，并内置终端、评审和打开编辑器的工作流。

• 同时运行多个代理，无需上下文切换开销
• 将每个任务隔离在其独立的 Git 工作树中，避免代理之间相互干扰
• 从一处监控所有代理，并在需要关注时收到通知
• 快速评审和编辑更改，借助内置的差异查看器和编辑器
• 一键将任意工作区传递给编辑器或终端，随时随地使用所需环境

等待更少，交付更多。

功能

支持的代理

Superset 兼容任何基于命令行的编码代理，包括：

只要能在终端中运行，就能在 Superset 上使用。

系统要求

开始使用

快速入门（预构建）

下载 Superset for macOS

从源码构建

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

cp .env.example .env
# 编辑 .env 并填写相应值

cp .env.example .env
echo 'SKIP_ENV_VALIDATION=1' >> .env

# 安装 caddy：brew install caddy（macOS）或参见 https://caddyserver.com/docs/install
cp Caddyfile.example Caddyfile

bun install
bun run dev

bun run build
open apps/desktop/release

键盘快捷键

所有快捷键均可通过 设置 > 键盘快捷键 (⌘/) 自定义。请参阅 完整文档。

工作区导航

终端

布局

配置

您可以在 .superset/config.json 中配置工作区的初始化和清理。请参阅 完整文档。

{
  "setup": ["./.superset/setup.sh"],
  "teardown": ["./.superset/teardown.sh"]
}

示例设置脚本

#!/bin/bash
# .superset/setup.sh

# 复制环境变量
cp ../.env .env

# 安装依赖
bun install

# 执行其他初始化任务
echo "工作区已准备就绪！"

脚本可以访问以下环境变量：

• SUPERSET_WORKSPACE_NAME — 工作区名称
• SUPERSET_ROOT_PATH — 主仓库路径

Mastra 依赖项

此仓库直接使用已发布的上游 mastracode 和 @mastra/* 包。除非存在特定于仓库的阻碍因素，否则请勿添加自定义 tarball 替代包。

技术栈

默认私密

• 源代码开放 — 完整源代码已在 GitHub 上以 Elastic License 2.0 (ELv2) 许可证发布。
• 明确连接 — 您可以选择要连接的代理、提供商和集成。

贡献

我们欢迎您的贡献！如果您有让 Superset 更好的建议：

1. 分支仓库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m '添加超赞功能')
4. 推送到该分支 (git push origin feature/amazing-feature)
5. 打开一个拉取请求

您也可以在 GitHub 上提交问题，报告 bug 或提出功能需求。

详细说明和行为准则请参阅 CONTRIBUTING.md。

社区

加入 Superset 社区，获取帮助、分享反馈并与其他用户交流：

• Discord — 与团队和社区聊天
• Twitter — 关注以获取最新动态和公告
• GitHub Issues — 报告 bug 和请求功能
• GitHub Discussions — 提问和分享想法

团队

许可证

根据 Elastic License 2.0 (ELv2) 发布。更多信息请参阅 LICENSE.md。

Superset 快速上手指南

Superset 是一款专为 AI 编码代理（AI Coding Agents）设计的编排工具。它允许你在隔离的 Git Worktree 中并行运行多个 CLI 模式的 AI 代理（如 Claude Code、Codex、Cursor Agent 等），无需频繁切换上下文，显著提升开发效率。

环境准备

在开始之前，请确保你的开发环境满足以下要求：

• 操作系统：macOS（Windows/Linux 尚未正式测试）
• 运行时环境：Bun v1.0+
• 版本控制：Git 2.20+
• GitHub CLI：需安装 gh 工具
• 反向代理：Caddy（用于本地开发服务器的 ElectricSQL 流，构建源码时需要）

提示：国内用户安装 Bun 可使用官方提供的国内镜像脚本：

curl -fsSL https://bun.sh/install | bash
# 若网络受阻，可尝试配置环境变量或使用代理
export BUN_INSTALL="$HOME/.bun"
export PATH="$BUN_INSTALL/bin:$PATH"

安装步骤

你可以选择下载预构建版本（推荐）或从源码构建。

方式一：下载预构建版本（推荐）

直接访问 GitHub Releases 下载最新的 macOS 安装包并安装。

方式二：从源码构建

如果你需要自定义功能或参与贡献，请按以下步骤操作：

1. 克隆仓库

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

2. 配置环境变量 复制示例配置文件。为了快速本地测试，可以跳过严格的环境验证：

cp .env.example .env
echo 'SKIP_ENV_VALIDATION=1' >> .env

3. 设置 Caddy (反向代理) 安装 Caddy (macOS: brew install caddy) 并复制配置文件：

cp Caddyfile.example Caddyfile

4. 安装依赖并启动开发服务

bun install
bun run dev

5. 构建桌面应用 (可选) 如果需要生成独立的桌面应用包：

bun run build
open apps/desktop/release

基本使用

Superset 的核心工作流是基于 Workspace (工作区) 和 Git Worktree 的隔离机制。

1. 创建新工作区

启动 Superset 后，使用快捷键 ⌘N 创建一个新的工作区。

• 每个工作区会自动创建一个独立的 Git branch 和 working directory。
• 你可以在这里指定要运行的 AI 代理命令（例如 claude 或 codex）。

2. 运行 AI 代理

在新建的工作区终端中，输入任何支持的 CLI 代理命令。例如：

claude
# 或者
npx @anthropics/claude-code

Superset 会自动在该隔离环境中运行代理，互不干扰。你可以同时开启多个工作区运行不同的任务。

3. 监控与审查

• 并行监控：在主界面查看所有代理的状态。当代理需要人工干预或完成任务时，你会收到通知。
• 代码审查：使用内置的 Diff 查看器（快捷键 ⌘L 切换变更面板）快速审查 AI 生成的代码修改。
• 外部编辑：选中任意工作区，按下 ⌘O 即可一键在你喜欢的编辑器（如 VS Code, Cursor）中打开该工作区目录进行深度编辑。

4. 常用快捷键

• ⌘1-9：切换到第 1-9 号工作区
• ⌘N：新建工作区
• ⌘T：新建终端标签页
• ⌘D / ⌘⇧D：左右/上下分屏
• ⌘O：在外部编辑器中打开当前工作区

5. 自动化配置 (可选)

你可以在项目根目录创建 .superset/config.json 来定义工作区的自动初始化和清理脚本：

{
  "setup": ["./.superset/setup.sh"],
  "teardown": ["./.superset/teardown.sh"]
}

示例 setup.sh：

#!/bin/bash
# 自动复制环境变量并安装依赖
cp ../.env .env
bun install
echo "Workspace ready!"

现在，你可以利用 Superset 同时调度多个 AI 代理，实现“等待更少，交付更多”的高效开发流程。