【开源】Swarmesh:基于 tmux 的多 AI CLI 蜂群协作框架,让 ClaudeGeminiCodex 自主协作完成复杂任务
- 内容介绍
- 文章标签
- 相关推荐
GitHub 项目地址:GitHub - Soein/swarmesh: tmux-based multi-AI CLI swarm collaboration framework
项目简介
Swarmesh 是一个基于 tmux 的多 AI CLI 蜂群协作框架。它能在一个 tmux session 中编排多个 AI CLI 实例(Claude Code、Gemini CLI、Codex 等),让它们通过消息系统自主协作完成复杂任务,无需人类中转。
核心思路
每个 AI 角色运行在独立的 tmux pane 中,拥有自己的角色配置、收件箱和可选的 git worktree。角色之间通过 swarm-msg.sh 自主通讯:
你(人类)
│
└──► swarm-start.sh
│
┌─────────┼─────────┐
▼ ▼ ▼
frontend backend reviewer ← tmux pane
Gemini Claude Codex ← 不同 AI CLI
│ │ │
└────► inbox/outbox ◄┘ ← 文件消息系统
+ paste-buffer ← 即时通知
主要特性
- 纯 Bash + 文件系统:无额外依赖,任何有 tmux 的机器都能跑
-
- CLI 无关:不绑定特定 AI CLI,支持通过 profile 配置混合使用不同 AI
-
- 角色自治:多角色通过消息系统自主协作,人类只需派发顶层任务
-
- Git worktree 隔离:每个角色可在独立分支上工作,避免冲突
-
- 质量门机制:任务完成时自动执行 build/test/lint 验证,失败则要求修复后重新提交
-
- 动态扩缩容:运行中可动态加入或移除角色
Profile 预设
| Profile | 角色数 | 适用场景 |
|---|---|---|
| minimal | 3 | 快速验证、小功能开发 |
| web-dev | 7 | Web 应用开发 |
| full-stack | 13 | 大型项目、企业级开发 |
快速使用
# 启动蜂群(交互式选择 profile)
./scripts/swarm-cli.sh start ~/my-app
# 派发任务给 supervisor(自动编排)
./scripts/swarm-cli.sh task 实现用户注册功能
# 查看蜂群状态
./scripts/swarm-cli.sh status
# 角色间发消息
swarm-msg.sh send backend "请设计用户认证 API"
# 广播给所有角色
swarm-msg.sh broadcast "v1 API 接口已定稿,请查收"
支持的 AI CLI
同一蜂群中可混合使用:Claude Code、Gemini CLI、Codex 等,各取所长。
感觉这个思路挺有意思的,相当于用 shell 脚本搭了一套 AI 多智能体协作基础设施,完全不依赖 Python/Node,只要有 tmux 就能跑。有在玩 AI 编程工具的朋友可以试试看。
网友解答:--【壹】--:
支持一下
--【贰】--:
前排支持,感觉很有意思
--【叁】--:
感谢大佬
--【肆】--:
支持佬!已star 研究一下
前几天看FARS直播写论文,对这种AI4AI还是挺感兴趣的
--【伍】--:
前排学习
--【陆】--:
今天刚推了几个比较大的更新,同步一下:
多实例架构升级
- role → instance 抽象,支持同角色跑多个实例,首实例 instance==role 向后兼容
-
- Pane 发送原子化,统一
_pane_locked_paste_enter,替代之前分散的 paste-buffer 逻辑
新增 PRD 角色
产品经理角色,覆盖需求分析到技术拆解的完整流程,full-stack profile 现在是 14 个角色
- Pane 发送原子化,统一
会话恢复(–resume)
stop 时保存工作摘要,resume 时自动注入上下文,孤儿任务也会被回收:
./scripts/swarm-start.sh --resume
统一路径管理 & 通知系统重构
- 各脚本移除重复路径定义,统一通过 swarm-lib.sh 管理
-
- 新增项目目录自动检测(从 CWD 向上查找
.swarm/runtime/state.json)
- 新增项目目录自动检测(从 CWD 向上查找
-
- 新增
_unified_notify统一通知入口,基于notification-policy.json配置 dual/inbox_only 投递策略
- 新增
-
- 新增
_cascade_fail_blocked级联失败机制,防止依赖链永久阻塞
Pane Watcher 增强
stall 检测 + supervisor/inspector 自动通知,卡住的 pane 不再需要人工介入
- 新增
--【柒】--:
要不要加上Grok作为搜索和外部知识来源呢
--【捌】--:
好像之前看过类似的项目
--【玖】--:
蜂群自我沟通,协作
--【拾】--:
似曾相识,好像之前在某个地方见过,不知道是不是你这个开源的,还是说有别的类似的
--【拾壹】--:
这个非常不错, 依赖少, 适应比较广
--【拾贰】--:
cli 是最小单元,cli和cli 可以通讯
--【拾叁】--:
gork 的话可以作为cli 的mcp 或者skils 接入
--【拾肆】--:
有点区别
--【拾伍】--:
佬,这个项目中,各个cli之间创建的agent可以互相通信吗
--【拾陆】--:
最新推送,今天(3月11日)又推了两个更新:
feat: 多 Supervisor 编排、角色权限边界与质量门严格模式
- 任务队列支持多 Supervisor 协作编排(council 广播、负载均衡分配)
-
- 所有角色配置新增功能指标与权限边界定义
-
- 新增质量门严格模式(
GATE_STRICT_MODE),失败后自动进入人工审批(pending_review)
- 新增质量门严格模式(
-
- 增强 pending_review 超时检测与通知
-
- CLI 新增任务管理命令扩展,消息系统增强多 Supervisor 路由支持
-
- 新增
product-feature工作流模板
docs: README 补充新功能文档并修正数据错误
- 新增
- 修正 profile 角色数(web-dev: 7→6,full-stack: 13→14)
-
- 补充任务干预、审计链、多 Supervisor 编排、质量门严格模式等新章节文档
项目更新节奏挺快的,多智能体协作的企业级特性越来越完善了
- 补充任务干预、审计链、多 Supervisor 编排、质量门严格模式等新章节文档
--【拾柒】--:
ccb,claude-code-bridge
--【拾捌】--:
感谢佬,谢谢分享
--【拾玖】--:
自己开源的
GitHub 项目地址:GitHub - Soein/swarmesh: tmux-based multi-AI CLI swarm collaboration framework
项目简介
Swarmesh 是一个基于 tmux 的多 AI CLI 蜂群协作框架。它能在一个 tmux session 中编排多个 AI CLI 实例(Claude Code、Gemini CLI、Codex 等),让它们通过消息系统自主协作完成复杂任务,无需人类中转。
核心思路
每个 AI 角色运行在独立的 tmux pane 中,拥有自己的角色配置、收件箱和可选的 git worktree。角色之间通过 swarm-msg.sh 自主通讯:
你(人类)
│
└──► swarm-start.sh
│
┌─────────┼─────────┐
▼ ▼ ▼
frontend backend reviewer ← tmux pane
Gemini Claude Codex ← 不同 AI CLI
│ │ │
└────► inbox/outbox ◄┘ ← 文件消息系统
+ paste-buffer ← 即时通知
主要特性
- 纯 Bash + 文件系统:无额外依赖,任何有 tmux 的机器都能跑
-
- CLI 无关:不绑定特定 AI CLI,支持通过 profile 配置混合使用不同 AI
-
- 角色自治:多角色通过消息系统自主协作,人类只需派发顶层任务
-
- Git worktree 隔离:每个角色可在独立分支上工作,避免冲突
-
- 质量门机制:任务完成时自动执行 build/test/lint 验证,失败则要求修复后重新提交
-
- 动态扩缩容:运行中可动态加入或移除角色
Profile 预设
| Profile | 角色数 | 适用场景 |
|---|---|---|
| minimal | 3 | 快速验证、小功能开发 |
| web-dev | 7 | Web 应用开发 |
| full-stack | 13 | 大型项目、企业级开发 |
快速使用
# 启动蜂群(交互式选择 profile)
./scripts/swarm-cli.sh start ~/my-app
# 派发任务给 supervisor(自动编排)
./scripts/swarm-cli.sh task 实现用户注册功能
# 查看蜂群状态
./scripts/swarm-cli.sh status
# 角色间发消息
swarm-msg.sh send backend "请设计用户认证 API"
# 广播给所有角色
swarm-msg.sh broadcast "v1 API 接口已定稿,请查收"
支持的 AI CLI
同一蜂群中可混合使用:Claude Code、Gemini CLI、Codex 等,各取所长。
感觉这个思路挺有意思的,相当于用 shell 脚本搭了一套 AI 多智能体协作基础设施,完全不依赖 Python/Node,只要有 tmux 就能跑。有在玩 AI 编程工具的朋友可以试试看。
网友解答:--【壹】--:
支持一下
--【贰】--:
前排支持,感觉很有意思
--【叁】--:
感谢大佬
--【肆】--:
支持佬!已star 研究一下
前几天看FARS直播写论文,对这种AI4AI还是挺感兴趣的
--【伍】--:
前排学习
--【陆】--:
今天刚推了几个比较大的更新,同步一下:
多实例架构升级
- role → instance 抽象,支持同角色跑多个实例,首实例 instance==role 向后兼容
-
- Pane 发送原子化,统一
_pane_locked_paste_enter,替代之前分散的 paste-buffer 逻辑
新增 PRD 角色
产品经理角色,覆盖需求分析到技术拆解的完整流程,full-stack profile 现在是 14 个角色
- Pane 发送原子化,统一
会话恢复(–resume)
stop 时保存工作摘要,resume 时自动注入上下文,孤儿任务也会被回收:
./scripts/swarm-start.sh --resume
统一路径管理 & 通知系统重构
- 各脚本移除重复路径定义,统一通过 swarm-lib.sh 管理
-
- 新增项目目录自动检测(从 CWD 向上查找
.swarm/runtime/state.json)
- 新增项目目录自动检测(从 CWD 向上查找
-
- 新增
_unified_notify统一通知入口,基于notification-policy.json配置 dual/inbox_only 投递策略
- 新增
-
- 新增
_cascade_fail_blocked级联失败机制,防止依赖链永久阻塞
Pane Watcher 增强
stall 检测 + supervisor/inspector 自动通知,卡住的 pane 不再需要人工介入
- 新增
--【柒】--:
要不要加上Grok作为搜索和外部知识来源呢
--【捌】--:
好像之前看过类似的项目
--【玖】--:
蜂群自我沟通,协作
--【拾】--:
似曾相识,好像之前在某个地方见过,不知道是不是你这个开源的,还是说有别的类似的
--【拾壹】--:
这个非常不错, 依赖少, 适应比较广
--【拾贰】--:
cli 是最小单元,cli和cli 可以通讯
--【拾叁】--:
gork 的话可以作为cli 的mcp 或者skils 接入
--【拾肆】--:
有点区别
--【拾伍】--:
佬,这个项目中,各个cli之间创建的agent可以互相通信吗
--【拾陆】--:
最新推送,今天(3月11日)又推了两个更新:
feat: 多 Supervisor 编排、角色权限边界与质量门严格模式
- 任务队列支持多 Supervisor 协作编排(council 广播、负载均衡分配)
-
- 所有角色配置新增功能指标与权限边界定义
-
- 新增质量门严格模式(
GATE_STRICT_MODE),失败后自动进入人工审批(pending_review)
- 新增质量门严格模式(
-
- 增强 pending_review 超时检测与通知
-
- CLI 新增任务管理命令扩展,消息系统增强多 Supervisor 路由支持
-
- 新增
product-feature工作流模板
docs: README 补充新功能文档并修正数据错误
- 新增
- 修正 profile 角色数(web-dev: 7→6,full-stack: 13→14)
-
- 补充任务干预、审计链、多 Supervisor 编排、质量门严格模式等新章节文档
项目更新节奏挺快的,多智能体协作的企业级特性越来越完善了
- 补充任务干预、审计链、多 Supervisor 编排、质量门严格模式等新章节文档
--【拾柒】--:
ccb,claude-code-bridge
--【拾捌】--:
感谢佬,谢谢分享
--【拾玖】--:
自己开源的

