Shogun 多智能体指挥系统
用 tmux 将多款编码 CLI 组织为可并行执行的层级式开发团队。
这个 Agent 能做什么，适合哪些场景？
multi-agent-shogun 是一个面向编码工作的 Shell/tmux 编排系统，将用户命令交给 Shogun，再经由 Karo 分配给 7 名 Ashigaru 工作者和 1 名 Gunshi 策略员。它可配置使用 Claude Code、OpenAI Codex、GitHub Copilot、Kimi Code、OpenCode、Cursor 或 Antigravity CLI，而不是调用单一云端 API。任务、收件箱和报告以 YAML 文件保存，Karo 汇总结果并更新 dashboard.md；tmux 窗格提供实时可见的执行界面。项目可用 projects/{name}.yaml 和 context/{name}.md 分隔上下文，并支持 Memory MCP、截图路径、ntfy 通知和 Android SSH 伴侣应用。它适合愿意在本机或 WSL/Linux 环境维护多个 CLI 会话，并需要显式并行分工的开发者。
运行 first_setup.sh 完成配置和依赖安装后，shutsujin_departure.sh 会创建 shogun 与 multiagent 两个 tmux 会话，并按 config/settings.yaml 为各角色启动所选 CLI。用户在 Shogun 窗格输入任务；Shogun 写入 queue/shogun_to_karo.yaml，Karo 将子任务写入 queue/tasks/，Ashigaru 和 Gunshi 在各自窗格中执行并将结果写入 queue/reports/。inbox_write.sh 与 inbox_watcher.sh 通过文件变更和短 tmux 提醒投递任务，Karo 聚合报告、更新 dashboard.md，并可处理 blockedBy 依赖。scripts/switch_cli.sh 可在运行中切换指定角色的 CLI 或模型；scripts/agent_status.sh 可查看窗格、任务和收件箱状态。
- 使用 Claude Code 或 Codex CLI 的独立开发者，需要把一个 REST API、测试和文档工作拆给多个并行会话。
- 在 WSL2 上开发的 Windows 用户，希望通过 tmux 观察 Shogun、Karo 和多个工作者的任务状态。
- 需要在 Claude Code、Codex、Copilot 或 OpenCode 之间按角色配置不同模型的团队。
- 管理多个长期代码项目的技术负责人，需要用 projects/{name}.yaml、context/{name}.md 和 YAML 队列保留项目上下文。
- 希望从 Android 手机通过 SSH 查看 tmux 窗格、发送命令，或经 ntfy 接收任务完成通知的开发者。
这个 Agent 有哪些优点和局限？
- 以 Shogun→Karo→Ashigaru/Gunshi 的职责层级组织任务，并通过独立 tmux 会话实现可见的并行执行。
- 任务、收件箱和报告保存在 YAML 文件中，便于检查、保留和排查，不依赖不可见的消息总线。
- 同一编排框架可按角色配置七类编码 CLI，并提供生成各 CLI 指令文件的统一构建流程。
- 包含项目上下文、任务依赖 blockedBy、实时 dashboard.md、状态检测和 ntfy/Android 远程访问等运行配套。
- 核心运行依赖 tmux、Bash、文件系统和多个交互式 CLI；Windows 用户需要 WSL2。
- 每个被选用的 CLI 都须单独安装、认证并具备相应订阅或提供商凭据，OpenCode 还需要配置其提供商认证。
- 默认启动与首次 Claude Code 认证文档包含 --dangerously-skip-permissions 和 Bypass Permissions，采用前需评估本机权限风险。
- Android 伴侣应用目前仅支持 Android；README 明确说明没有 iOS 版本。
- 并行执行会同时占用多个 CLI 会话，实际吞吐量、额度和模型可用性取决于所配置的服务商。
如何安装或部署这个 Agent？
前提：tmux、Bash 4+，以及至少一个受支持的编码 CLI。Linux/macOS 可执行：
git clone https://github.com/yohey-w/multi-agent-shogun.git ~/multi-agent-shogun
cd ~/multi-agent-shogun
chmod +x *.sh
./first_setup.sh
重新加载 PATH：source ~/.bashrc。若使用 Claude Code，首次还需运行 claude --dangerously-skip-permissions，完成 OAuth 并接受 Bypass Permissions，然后输入 /exit。Windows 路径可将仓库放在 C:\tools\multi-agent-shogun，运行 install.bat，再在 WSL Ubuntu 中执行 ./first_setup.sh。
如何使用这个 Agent？
在仓库目录运行 ./shutsujin_departure.sh。随后在另一终端执行 tmux attach-session -t shogun，并直接输入开发命令，例如“Build a REST API for user authentication”。系统会将命令交给 Karo，并把子任务分配给工作者；用 dashboard.md 查看汇总进度，或运行 bash scripts/agent_status.sh 查看状态。要为某个角色切换 CLI/模型，可使用例如：bash scripts/switch_cli.sh ashigaru3 --type opencode --model openrouter/openai/gpt-4o-mini。
这个 Agent 与同类方案有什么区别？
相较于 Claude Code 的 Task 工具、Claude Code Agent Teams、LangGraph 和 CrewAI，本项目采用 tmux 中独立 CLI 会话加 YAML 文件通信的结构。它强调可在窗格中直接观察各角色，并支持多种编码 CLI；相应地，部署和会话管理由本地 Shell 脚本承担。