superset-sh/superset

Source: https://github.com/superset-sh/superset

AI 代理的代码编辑器

GitHub stars (https://github.com/superset-sh/superset/stargazers) GitHub release (https://github.com/superset-sh/superset/releases) License Twitter (https://x.com/superset_sh) Discord (https://discord.gg/cZeD9WYcV7)

协调多个 Claude Code、Codex 等代理并行工作。适用于任何 CLI 代理。专为基于本地工作树的开发而设计。

下载 macOS 版本 (https://github.com/superset-sh/superset/releases/latest) • 文档 (https://docs.superset.sh) • 变更日志 (https://github.com/superset-sh/superset/releases) • Discord (https://discord.gg/cZeD9WYcV7)

无切换成本，编码速度提升10倍

Superset 在独立的 git 工作树中协调基于 CLI 的编码代理，内置终端、审查和打开编辑器的工作流。

• 同时运行多个代理，无需上下文切换开销
• 将每个任务隔离到自己的 git 工作树，避免代理互相干扰
• 从一个地方监控所有代理，并在需要关注时收到通知
• 快速审查和编辑更改，借助内置 diff 查看器和编辑器
• 一键打开任意工作区，交给你的编辑器或终端

减少等待，加速交付。

功能

支持的代理

Superset 适用于任何基于 CLI 的编码代理，包括：

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

要求

快速开始

快速启动（预编译）

下载 macOS 版 Superset (https://github.com/superset-sh/superset/releases/latest)

从源码构建

点击展开构建说明

1. 克隆仓库

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

2. 设置环境变量（二选一）：

选项 A：完整配置

cp .env.example .env
# 编辑 .env 并填入值

选项 B：跳过环境变量验证（用于本地快速测试）

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

3. 设置 Caddy（Electric SQL 流的反向代理）：

# 安装 caddy：brew install caddy（macOS）或访问 https://caddyserver.com/docs/install
cp Caddyfile.example Caddyfile
# 否则 Chromium 会拒绝 https://localhost:* 并报 ERR_CERT_AUTHORITY_INVALID。
# 需要一次 sudo 权限。
caddy trust

4. 安装依赖并运行

bun install
bun run dev

5. 构建桌面应用

bun run build
open apps/desktop/release

键盘快捷键

所有快捷键均可通过 设置 > 键盘快捷键（⌘/）自定义。查看完整文档 (https://docs.superset.sh/keyboard-shortcuts)。

工作区导航

终端

布局

配置

在 .superset/config.json 中配置工作区的设置和清理。查看完整文档 (https://docs.superset.sh/setup-teardown-scripts)。

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

示例 setup 脚本

#!/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. Fork 此仓库
2. 创建你的功能分支 (git checkout -b feature/amazing-feature)
3. 提交你的更改 (git commit -m '添加超棒功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

你也可以通过提交 issue (https://github.com/superset-sh/superset/issues) 来报告 bug 或提出功能请求。详细说明和行为准则请参见 CONTRIBUTING.md。

社区

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

• Discord (https://discord.gg/cZeD9WYcV7) — 与团队和社区聊天
• Twitter (https://x.com/superset_sh) — 关注更新和公告
• GitHub Issues (https://github.com/superset-sh/superset/issues) — 报告 bug 和请求功能
• GitHub Discussions (https://github.com/superset-sh/superset/discussions) — 提问和分享想法

团队

Avi Twitter (https://x.com/avimakesrobots) Kiet Twitter (https://x.com/flyakiet) Satya Twitter (https://x.com/saddle_paddle)

许可证

基于 Elastic License 2.0 (ELv2) 分发。详情请参见 LICENSE.md。