Shogun 多智能体指挥系统
用 tmux 将多款编码 CLI 组织为可并行执行的层级式开发团队。
- Star 数
- ★ 1.4k
- 最近更新
- 3 个月前
- License
- MIT
- 主语言
- Shell
- FA 评分
- 48/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 使用 Claude Code 或 Codex CLI 的独立开发者，需要把一个 REST API、测试和文档工作拆给多个并行会话。
- 不适合
- 没有 tmux、Bash 和 Linux/WSL 终端环境的用户
- 不愿接受 --dangerously-skip-permissions 绕过权限的团队
- 需要 iOS 手机端监控的用户
这个 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？
前提：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 有哪些优点和局限？
- 以 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 与同类方案有什么区别？
相较于 Claude Code 的 Task 工具、Claude Code Agent Teams、LangGraph 和 CrewAI，本项目采用 tmux 中独立 CLI 会话加 YAML 文件通信的结构。它强调可在窗格中直接观察各角色，并支持多种编码 CLI；相应地，部署和会话管理由本地 Shell 脚本承担。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Shogun 多智能体指挥系统 当前 | 48 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.4k | 3 个月前 | Shell | Codex · Claude Code |
| Oh My OpenAgent | 49 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 71k | 今天 | TypeScript | Claude Code |
| Agent Deck | 76 · 表现良好 | 命令行工具免费 + 模型费 | ★ 1.2k | 今天 | Go | Codex · Claude Code |
| CLI Agent Orchestrator | 65 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.5k | 今天 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：README 描述了基于 YAML 文件通信的架构，并强调透明性（每个 agent 在可见的 tmux 窗格中运行）。SECURITY.md 提供了安全最佳实践，包括使用环境变量存储密钥、避免硬编码令牌、使用强 ntfy 主题，以及通过 .gitignore 排除敏感目录。然而，没有证据表明存在最小权限机制（例如，agent 可以访问所有文件），也没有用户确认机制（例如，在执行命令前请求批准）。数据流透明性部分得到支持，因为 YAML 文件可读且可版本控制，但缺乏对敏感数据处理的明确说明。依赖安全仅通过 requirements.txt 中的 pyyaml 和 CI 中的 shellcheck 得到部分支持。外部影响（如 ntfy 通知）已记录，但未提供回滚机制。来源归属仅通过 MIT 许可证和作者姓名得到部分支持。
证据显示：README 和 CI 工作流表明存在测试套件（bats 测试、E2E 测试），但未提供测试结果。依赖可用性部分得到支持，因为列出了依赖项（tmux、bash、CLI 工具），但未提供版本固定。失败消息部分得到支持，因为 CI 工作流包含错误输出，但未提供用户友好的错误处理。
证据显示：README 描述了多种使用场景（Windows/WSL2、Linux/macOS、移动访问），并提供了详细的安装说明。能力边界通过角色定义（Shogun、Karo、Ashigaru、Gunshi）得到部分支持，但未明确说明限制。触发精度部分得到支持，因为命令通过 YAML 文件传递，但未提供精确的触发条件。环境适配性通过支持多种 CLI 和操作系统得到支持。
证据显示：README 提供了清晰的信息架构（目录结构、脚本参考）。安装说明详细，包括 Windows 和 Linux/macOS。命名稳定性部分得到支持，因为存在版本标签（v5.1.0），但未提供变更日志。示例和 FAQ 部分得到支持，因为 README 包含示例和常见问题解答。已知限制部分得到支持，因为 SECURITY.md 和 README 中提到了限制（例如，仅 Android 应用）。许可证为 MIT，版本控制通过 Git 标签部分支持，维护责任通过 SECURITY.md 中的安全政策部分支持。
证据显示：README 声称输出为 YAML 文件，可读且可版本控制，支持输出可用性。边际价值通过与其他框架的比较得到支持，声称零协调开销。成本效益通过 CLI 订阅与 API 定价的比较得到支持。
证据显示：README 中的声明（例如，零协调开销、8 个独立 agent）未通过可复现的测试或基准得到验证。跨来源佐证有限，因为仅提供了单一来源。事实与推断的分离部分得到支持，因为 README 区分了功能描述和性能声明，但未明确标注。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 未验证的发布者身份：发布者未在 FollowAgents 企业注册表中验证，应视为未知身份。
- 缺少最小权限和用户确认机制：agent 可能拥有对文件系统的广泛访问权限，且没有在执行命令前请求用户批准的机制。
- 依赖安全有限：仅列出 pyyaml，未提供版本固定或漏洞扫描。
- 回滚机制缺失：没有证据表明可以回滚 agent 的操作。
- 测试结果未提供：CI 工作流存在，但未提供测试结果，无法验证可靠性声明。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v5.1.0 v5.1.0 - Karo as Traffic Controller
发布说明摘录
Changed - Clarified Karo as a workflow traffic controller instead of an execution bottleneck - Moved qualitative review ownership to Gunshi for QC, evidence review, RCA, adoption/drop decisions, and deploy blocker classification - Reframed E2E ownership: Karo reviews the plan, checks prerequisites, and makes the final pass/fail decision while execution is delegated by default - Regenerated Claude, Codex, Copilot, Kimi, and OpenCode instruction files from the updated role definitions Fixed …在 GitHub 查看 ↗ -
v5.0.0 v5.0.0 - OpenCode First-Class Support
发布说明摘录
Highlights - OpenCode is now a first-class CLI for Shogun, Karo, Ashigaru 1-7, and Gunshi. - Generated .opencode/agents/*.md files define role-specific OpenCode agents from the shared instruction source. - config/opencode-permissions.yaml scopes OpenCode role permissions. - config/opencode-tui.json pins tmux-safe keybindings. - settings.yaml supports provider-qualified OpenCode model IDs such as opencode/qwen3.6-plus-free and openrouter/openai/gpt-4o-mini. Fixes - macOS CI now uses the project venv for scripts/slim_yaml.py, fixing PyYAML import failures. …在 GitHub 查看 ↗ -
发布说明摘录
[4.6.0] - 2026-04-19 Added - shutsujin_departure.sh: --auto-mode-on flag (maps to --dangerously-skip-permissions) and --permission-mode <mode> for custom permission flags (Issue #124) - lib/cli_adapter.sh: accept PERMISSION_FLAG override from departure script, backward-compatible Fixed - Report flow unified to Ashigaru → Gunshi → Karo across all instruction files (instructions/ashigaru.md, karo.md, gunshi.md, CLAUDE.md, all generated CLI variants) (Issue #121) Changed …在 GitHub 查看 ↗