简介

Superset​ 是一个专为 CLI（命令行）智能体（AI Coding Agents）设计的强化终端环境。它解决了开发者在同时运行多个 AI 编程助手（如 Claude Code、Cursor AI、Codex 等）时面临的环境冲突、上下文切换混乱、任务难以并行等痛点。通过底层集成 Git Worktree 隔离技术和统一的任务监控面板，Superset 让你能像管理 Kubernetes Pod 一样管理你的 AI 智能体，真正实现“少等待，多交付”（Wait less, ship more）。

主要功能

1. 多智能体并行执行：支持同时运行 10+ 个 CLI 智能体任务，互不干扰，充分利用多核性能。

2. Git Worktree 工作区隔离：每个智能体任务自动创建独立的 Git 工作树（Worktree）和分支，确保文件修改、依赖安装和环境变量完全隔离，避免“串门”事故。

3. 统一监控与通知：提供桌面级监控界面，实时查看所有智能体的运行状态、资源消耗和进度；任务完成或遇到阻塞时主动推送通知。

4. 内置 Diff 查看器与编辑器：集成图形化差异对比工具，无需切换 IDE 即可快速 Review 智能体生成的代码变更，并支持就地编辑。

5. 泛用性兼容：遵循“If it runs in a terminal, it runs on Superset”原则，理论上兼容任何命令行交互的 AI 工具，无需特定 SDK 集成。

6. Electric SQL 数据同步：通过 Caddy 反向代理支持 Electric SQL 流式同步，为多设备状态同步提供基础设施。

安装与配置

环境要求

• Node.js​ 18+ 环境（推荐使用 Bun 运行时）。

• Git 2.20+。

• 本地已安装并配置好目标 CLI 智能体（如 claude、cursor命令）。

安装步骤

1. 克隆仓库：

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

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

   • 完整配置：复制 .env.example为 .env，填入你的 AI 服务商 API Key（如 ANTHROPIC_API_KEY）及代理设置。

   • 快速测试：直接运行跳过验证的脚本，仅用于本地功能体验。

3. 设置 Caddy：部署项目提供的 Caddyfile 配置，以启用 Electric SQL 流代理功能（用于跨设备状态同步）。

4. 安装依赖并启动：

   bun install    # 或使用 npm/pnpm
   bun run dev    # 启动开发模式

5. 构建桌面版（可选）：项目基于 Electron 提供桌面应用封装，可通过构建脚本生成本地可执行文件。

如何使用

1. 初始化项目：在 Superset 终端中导航至你的代码仓库根目录，系统会自动识别项目结构。

2. 启动智能体：使用 superset run [agent-name]命令启动配置好的智能体。Superset 会自动在后台创建 worktrees/目录并挂载独立工作区。

3. 任务监控：打开 Superset 的 Dashboard 界面（通常运行在本地特定端口），查看所有活跃智能体的实时输出日志和状态。

4. 交互与审查：当智能体产出代码后，在 Dashboard 的“Changes”标签页中使用内置 Diff 工具审查修改，确认无误后可直接提交或通过编辑器调整。

5. 环境变量管理：Superset 支持项目级环境变量（.superset/config.json），智能体脚本会自动继承这些变量，无需手动在每个终端中重复设置。

应用场景实例

• 场景一：多需求并行开发

  你同时接到三个需求：重构用户认证模块、优化数据库查询性能、修复前端 UI Bug。传统方式只能串行处理或开多个终端标签页手动切换。使用 Superset，你可以分别启动三个 Claude Code 智能体，每个智能体在独立的 Worktree 中处理一个需求。你可以同时监控三个任务的进度，互不干扰，开发效率提升数倍。

• 场景二：大规模代码库自动化重构

  需要对一个大型 Monorepo 进行统一的 ESLint 规则升级。传统方式风险高，容易破坏其他包。使用 Superset，启动一个专门的重构智能体，将其隔离在特定的 Worktree 分支上运行自动化脚本。你可以在 Dashboard 中实时观察文件变更，利用 Diff 视图筛选出非预期的破坏性修改，确认安全后再合并回主分支。

• 场景三：团队智能体协作

  团队统一使用 Superset 作为开发入口。通过配置共享的 Electric SQL 同步，团队成员的智能体任务状态（如“代码审查中”、“测试通过”）可以实时同步到云端看板，方便项目经理或 Tech Lead 统一查看全团队的 AI 辅助开发进度，而无需逐个询问。

GitHub 地址

项目仓库：https://github.com/superset-sh/superset

开源协议：Elastic License 2.0 (ELv2)