multi-agent-shogun

像封建军阀一样指挥你的 AI 军队。

通过受武士启发的层级架构（Shogun → Karo → Ashigaru），零协调开销地并行运行 10 个 AI 编程智能体 —— Claude Code、OpenAI Codex、GitHub Copilot、Kimi Code、OpenCode。

只谈编程，不谈“玄学编码”（Vibe Coding）。对着你的手机说话，AI 负责执行。

English | 日本語

一个 Karo（主管）协调 7 个 Ashigaru（执行者）+ 1 个 Gunshi（战略家）—— 真实会话，非模拟数据。

---

快速开始

需求： tmux, bash 4+，以及以下至少一种工具：Claude Code / Codex / Copilot / Kimi / OpenCode

git clone https://github.com/yohey-w/multi-agent-shogun
cd multi-agent-shogun
bash first_setup.sh                        # 一次性设置：配置、依赖项、MCP
source ~/.bashrc                           # 重新加载 PATH
claude --dangerously-skip-permissions      # 仅首次运行：OAuth + 接受 Bypass Permissions → /exit
bash shutsujin_departure.sh                # 启动所有智能体

有关完整的安装步骤（包括 Windows）和前 30 分钟的使用指南，请参阅 🚀 快速开始 以及下方的基础使用章节。

在 Shogun 面板输入命令：

"Build a REST API for user authentication"（为用户身份验证构建一个 REST API）

Shogun 进行任务委派 → Karo 拆解任务 → 7 个 Ashigaru 并行执行。 你只需查看仪表盘即可。就是这么简单。

想了解更多？ 本 README 的其余部分涵盖了架构、配置、内存设计以及多 CLI 设置。

---

这是什么？

multi-agent-shogun 是一个系统，它能够同时运行多个 AI 编程 CLI 实例，并像封建日本军队一样组织它们。支持 Claude Code、OpenAI Codex、GitHub Copilot、Kimi Code 和 OpenCode。

为什么要使用它？

• 一条命令启动 7 个 AI 执行者 + 1 个战略家并行工作
• 零等待时间 —— 当任务在后台运行时，你可以发布下一条指令
• AI 在不同会话间保留你的偏好（Memory MCP）
• 在仪表盘上实时查看进度

        You (上様 / 主公)
             │
             ▼  下达命令
      ┌─────────────┐
      │   SHOGUN    │  ← 接收你的命令，即时委派
      └──────┬──────┘
             │  YAML + tmux
      ┌──────▼──────┐
      │    KARO     │  ← 将任务分配给执行者
      └──────┬──────┘
             │
    ┌─┬─┬─┬─┴─┬─┬─┬─┬────────┐
    │1│2│3│4│5│6│7│ GUNSHI │  ← 7 个执行者 + 1 个战略家
    └─┴─┴─┴─┴─┴─┴─┴────────┘
       ASHIGARU      军师

---

为什么选择 Shogun？

大多数多智能体框架在协调过程中会消耗大量的 API Token。而 Shogun 不会。

特性	Claude Code Task 工具	Claude Code 智能体团队	LangGraph	CrewAI	multi-agent-shogun
架构	单进程内的子智能体	团队负责人 + 队员 (JSON 邮箱)	基于图的状态机	基于角色的智能体	通过 tmux 实现的封建层级
并行能力	顺序执行（一次一个）	多个独立会话	并行节点 (v0.2+)	有限	8 个独立智能体
协调成本	每个任务进行 API 调用	Token 消耗大（每个队友即独立上下文）	API + 基础设施 (Postgres/Redis)	API + CrewAI 平台	零 (YAML + tmux)
多 CLI 支持	仅限 Claude Code	仅限 Claude Code	任意 LLM API	任意 LLM API	5 种 CLI
可观测性	仅限 Claude 日志	tmux 分屏或进程内	集成 LangSmith	OpenTelemetry	实时 tmux 面板 + 仪表盘
技能发现	无	无	无	无	自下而上的自动提议
安装	内置于 Claude Code	内置 (实验性)	复杂 (需要基础设施)	pip install	Shell 脚本

它的独特之处

零协调开销 —— 智能体通过磁盘上的 YAML 文件进行通信。唯一的 API 调用仅用于实际工作，而非用于编排。运行 8 个智能体，你只需为这 8 个智能体的工作付费。

完全透明 —— 每个智能体都在一个可见的 tmux 面板中运行。每一条指令、报告和决策都是你可以阅读、对比（diff）和版本控制的纯文本 YAML 文件。没有黑盒。

久经考验的层级架构 —— Shogun → Karo → Ashigaru 的指挥链通过设计避免了冲突：明确的所有权、每个智能体专属的文件、事件驱动的通信，且无需轮询。

---

为什么选择 CLI