yohey-w/multi-agent-shogun
Samurai-inspired multi-agent system for Claude Code. Orchestrate parallel AI tasks via tmux with shogun → karo → ashigaru hierarchy.
What it solves
它消除了运行多个 AI 编程代理(agents)所带来的高昂 API 成本和协调开销。它不再为编排过程支付按 token 计费的费用,而是利用固定费率的 CLI 订阅来并行运行多个独立的代理,而不会在内部通信上消耗 token。
How it works
该系统采用了一种通过 tmux 分屏和磁盘上的 YAML 文件实现的日本封建等级制度(Shogun $\rightarrow$ Karo $\rightarrow$ Ashigaru)。
- Shogun: 接收用户命令并进行委派。
- Karo: 管理代理,负责将任务分解并分发给工作者。
- Ashigaru: 七个并行执行任务的工作代理。
- Gunshi: 负责审查报告的策略代理。
代理之间通过 YAML 文件进行异步通信,这意味着不会在协调工作上浪费任何 API 调用。它支持多种 CLI 工具,包括 Claude Code、OpenAI Codex、GitHub Copilot、Kimi Code、OpenCode、Cursor 和 Antigravity,并使用统一的指令构建系统来保持不同供应商之间规则的一致性。
Who it’s for
希望部署“军队”般的 AI 代理来并行处理复杂编程任务,同时保持完全透明度和可预测的每月成本的开发者。
Highlights
- Zero Coordination Overhead: 使用基于磁盘的 YAML 通信,而非基于 API 的编排。
- Multi-CLI Support: 兼容 7 种不同的 AI 编程 CLI,允许用户混合搭配使用其优势。
- Bottom-Up Skill Discovery: 代理在工作过程中会自动识别可重用的模式,并将其作为永久技能提议给用户审批。
- Live Observability: 每个代理都在自己可见的
tmux面板中运行,并配有实时仪表板。 - Mobile Command Center: 包括一个专门的 Android 应用,用于通过 SSH 和语音输入来监控代理并发送命令。
相关
- 项目
- 项目
- 项目
- 项目
- 项目