BumbaClaude：Claude Code 多智能体任务的指挥中枢

BumbaClaude 是一个独立的 Web 仪表盘，用于管理和监控多个 Claude Code 智能体的协作工作流。无需修改 Claude Code 本身，即可实现团队定义、实时监控、权限治理和完整审计。

多智能体时代的管理困境\n\n随着 Claude Code 等 AI 编程助手的普及，开发者开始探索让多个智能体协作完成复杂任务的可能性。然而，管理多个并行的 Claude Code 会话很快变得混乱：\n\n- 如何同时监控多个智能体的实时输出？\n- 如何为不同智能体分配特定角色和权限？\n- 当某个智能体偏离轨道时，如何及时干预？\n- 如何保留完整的操作记录以供审计？\n\nBumbaClaude 正是为解决这些问题而生——一个独立于 Claude Code 的 Web 仪表盘，充当多智能体工作流的"任务控制中心"。\n\n## 项目定位：零侵入的外部协调层\n\nBumbaClaude 的核心设计理念是"不修改 Claude Code 本身"。它通过三种公开接口与 Claude Code 交互：\n\n1. tmux 会话：创建、监控和控制 Claude Code 进程\n2. 文件系统状态：读取 Claude Code 写入 ~/.claude/ 的 JSON 邮箱和任务文件\n3. Agent SDK（可选，v0.2）：通过官方 API 进行程序化控制\n\n这种设计意味着：无需 fork、无需补丁、无需修改 Claude Code 的源码或二进制文件。BumbaClaude 完全作为外部协调层存在。\n\n## 核心功能：从定义到审计的完整闭环\n\n### 1. 团队定义（Team Definition）\n\n创建可复用的智能体团队配置，包括：\n- 自定义角色（如"架构师"、"测试员"、"文档编写者"）\n- 模型层级选择（Claude 3 Opus/Sonnet/Haiku）\n- 治理规则（权限边界、回合数限制）\n\n### 2. 一键启动（Workflow Launch）\n\n从仪表盘一键启动多智能体 Claude Code 会话，无需手动打开多个终端。\n\n### 3. 实时监控（Live Monitoring）\n\n- 实时查看每个智能体的终端输出\n- 跟踪任务进度和状态\n- 向特定智能体发送消息进行干预\n\n### 4. 权限治理（Governance）\n\n在智能体创建前设置权限边界：\n- 文件创建限制\n- Shell 命令执行控制\n- Git 推送权限\n- 最大回合数限制\n\n### 5. 完整审计（Audit Trail）\n\n- 记录所有智能体活动的完整事件日志\n- 时间戳标记\n- 按智能体和事件类型筛选\n\n### 6. 模板保存（Templates）\n\n将团队配置打包为可复用的工作流模板，支持导出为 JSON 格式以便分享。\n\n## 技术栈与架构\n\nBumbaClaude 采用现代 Web 技术栈构建：\n\n- 前端：Next.js 14+（App Router + TypeScript）\n- 样式：Tailwind CSS（默认深色模式）\n- 数据库：SQLite（通过 better-sqlite3，零配置本地存储）\n- 实时通信：WebSocket（智能体状态流式传输）\n- 文件监控：chokidar（监视 Claude Code 的文件系统状态）\n\n这种技术选择体现了"轻量、独立、易部署"的设计哲学。\n\n## 使用场景：谁需要 BumbaClaude\n\n复杂功能开发：将大型功能拆分为多个子任务，分配给不同专长的智能体并行处理\n\n代码审查自动化：配置专门的审查智能体，对主开发智能体的输出进行实时检查\n\n多语言项目：为不同编程语言配置专门的智能体，协同完成跨语言项目\n\n安全敏感环境：通过严格的权限治理，确保智能体不会越权操作\n\n团队协作：保存和分享工作流模板，让团队成员快速复用成功的多智能体配置\n\n## 快速开始\n\nbash\ngit clone https://github.com/twamp22/BumbaClaude.git\ncd BumbaClaude\npnpm install\npnpm dev\n\n\n打开 http://localhost:3000 即可使用。\n\n前置要求：\n- Node.js 18+\n- pnpm\n- tmux（已安装且在 PATH 中）\n- Claude Code（claude 命令可用）\n- Claude Max 订阅或 API 密钥\n\n## 路线图：从 MVP 到完整生态\n\nv0.1（MVP）：仪表盘首页、团队创建向导、实时监控、任务列表、审计日志、工作流模板\n\nv0.2：Agent SDK 集成、细粒度权限控制、Token 追踪、模板分享\n\nv0.3：看板视图、上下文可视化、工作流回放、Webhook 通知\n\nv0.4：插件系统、公共模板仓库、GitHub Actions 集成\n\n## 设计哲学与社区\n\nBumbaClaude 体现了开源社区对 AI 工具链的补全思路：不等待官方提供所有功能，而是围绕核心工具构建生态。这种"外部增强"模式既保持了核心工具的简洁，又满足了高级用户的复杂需求。\n\n项目采用 MIT 许可证，欢迎社区贡献。无论是 Bug 报告、功能建议、文档改进还是代码贡献，都被视为有价值的参与。\n\n## 总结：多智能体编排的新思路\n\nBumbaClaude 的价值不仅在于其具体功能，更在于其架构思路——通过标准接口（tmux、文件系统、API）协调外部进程，而非深度集成。这种模式：\n\n- 降低了与核心工具版本绑定的风险\n- 允许独立迭代和创新\n- 为其他 AI 工具的多实例管理提供了参考范式\n\n随着 AI 编程助手能力的增强，多智能体协作将成为常态。BumbaClaude 这类协调工具，正在为这个未来铺设基础设施。

多智能体时代的管理困境\n\n随着 Claude Code 等 AI 编程助手的普及，开发者开始探索让多个智能体协作完成复杂任务的可能性。然而，管理多个并行的 Claude Code 会话很快变得混乱：\n\n- 如何同时监控多个智能体的实时输出？\n- 如何为不同智能体分配特定角色和权限？\n- 当某个智能体偏离轨道时，如何及时干预？\n- 如何保留完整的操作记录以供审计？\n\nBumbaClaude 正是为解决这些问题而生——一个独立于 Claude Code 的 Web 仪表盘，充当多智能体工作流的"任务控制中心"。\n\n项目定位：零侵入的外部协调层\n\nBumbaClaude 的核心设计理念是"不修改 Claude Code 本身"。它通过三种公开接口与 Claude Code 交互：\n\n1. tmux 会话：创建、监控和控制 Claude Code 进程\n2. 文件系统状态：读取 Claude Code 写入 ~/.claude/ 的 JSON 邮箱和任务文件\n3. Agent SDK（可选，v0.2）：通过官方 API 进行程序化控制\n\n这种设计意味着：无需 fork、无需补丁、无需修改 Claude Code 的源码或二进制文件。BumbaClaude 完全作为外部协调层存在。\n\n核心功能：从定义到审计的完整闭环\n\n1. 团队定义（Team Definition）\n\n创建可复用的智能体团队配置，包括：\n- 自定义角色（如"架构师"、"测试员"、"文档编写者"）\n- 模型层级选择（Claude 3 Opus/Sonnet/Haiku）\n- 治理规则（权限边界、回合数限制）\n\n2. 一键启动（Workflow Launch）\n\n从仪表盘一键启动多智能体 Claude Code 会话，无需手动打开多个终端。\n\n3. 实时监控（Live Monitoring）\n\n- 实时查看每个智能体的终端输出\n- 跟踪任务进度和状态\n- 向特定智能体发送消息进行干预\n\n4. 权限治理（Governance）\n\n在智能体创建前设置权限边界：\n- 文件创建限制\n- Shell 命令执行控制\n- Git 推送权限\n- 最大回合数限制\n\n5. 完整审计（Audit Trail）\n\n- 记录所有智能体活动的完整事件日志\n- 时间戳标记\n- 按智能体和事件类型筛选\n\n6. 模板保存（Templates）\n\n将团队配置打包为可复用的工作流模板，支持导出为 JSON 格式以便分享。\n\n技术栈与架构\n\nBumbaClaude 采用现代 Web 技术栈构建：\n\n- 前端：Next.js 14+（App Router + TypeScript）\n- 样式：Tailwind CSS（默认深色模式）\n- 数据库：SQLite（通过 better-sqlite3，零配置本地存储）\n- 实时通信：WebSocket（智能体状态流式传输）\n- 文件监控：chokidar（监视 Claude Code 的文件系统状态）\n\n这种技术选择体现了"轻量、独立、易部署"的设计哲学。\n\n使用场景：谁需要 BumbaClaude\n\n复杂功能开发：将大型功能拆分为多个子任务，分配给不同专长的智能体并行处理\n\n代码审查自动化：配置专门的审查智能体，对主开发智能体的输出进行实时检查\n\n多语言项目：为不同编程语言配置专门的智能体，协同完成跨语言项目\n\n安全敏感环境：通过严格的权限治理，确保智能体不会越权操作\n\n团队协作：保存和分享工作流模板，让团队成员快速复用成功的多智能体配置\n\n快速开始\n\nbash\ngit clone https://github.com/twamp22/BumbaClaude.git\ncd BumbaClaude\npnpm install\npnpm dev\n\n\n打开 http://localhost:3000 即可使用。\n\n前置要求：\n- Node.js 18+\n- pnpm\n- tmux（已安装且在 PATH 中）\n- Claude Code（claude 命令可用）\n- Claude Max 订阅或 API 密钥\n\n路线图：从 MVP 到完整生态\n\nv0.1（MVP）：仪表盘首页、团队创建向导、实时监控、任务列表、审计日志、工作流模板\n\nv0.2：Agent SDK 集成、细粒度权限控制、Token 追踪、模板分享\n\nv0.3：看板视图、上下文可视化、工作流回放、Webhook 通知\n\nv0.4：插件系统、公共模板仓库、GitHub Actions 集成\n\n设计哲学与社区\n\nBumbaClaude 体现了开源社区对 AI 工具链的补全思路：不等待官方提供所有功能，而是围绕核心工具构建生态。这种"外部增强"模式既保持了核心工具的简洁，又满足了高级用户的复杂需求。\n\n项目采用 MIT 许可证，欢迎社区贡献。无论是 Bug 报告、功能建议、文档改进还是代码贡献，都被视为有价值的参与。\n\n总结：多智能体编排的新思路\n\nBumbaClaude 的价值不仅在于其具体功能，更在于其架构思路——通过标准接口（tmux、文件系统、API）协调外部进程，而非深度集成。这种模式：\n\n- 降低了与核心工具版本绑定的风险\n- 允许独立迭代和创新\n- 为其他 AI 工具的多实例管理提供了参考范式\n\n随着 AI 编程助手能力的增强，多智能体协作将成为常态。BumbaClaude 这类协调工具，正在为这个未来铺设基础设施。