Brigade 是一个面向 AI 编程代理的本地优先命令行控制平面，由 escoffier-labs 开发，采用 MIT 许可证。它的目标是让编码代理的工作跨工具、仓库和会话保持可追踪，核心围绕任务、回执、共享记忆和同步工具展开。发布时间线方面，v0.27.0 是已发布的稳定安装版本（PyPI 包名 brigade-cli==0.27.0），主分支已进入 0.28 测试线。
一、主要能力 Brigade 提供以下能力：
- 就绪工作与认领安全：列出未被阻塞的任务，并使用原子认领机制，防止两个代理同时领取同一任务。
- 声明的运行限制、可选 fleet hub 与已注册云活动：执行声明的墙钟时间和工作分派上限，记录具名的重试与重路由决策，可通过操作者拥有的 fleet hub 报告运行、仓库认领和外部 harness 会话，并将已注册的云工作与提供商及 GitHub 状态进行核对。
- 验证回执（Verification receipts）：通过 Brigade 执行的检查会写入命令、真实退出码和 Git 状态。注意并非每个 Brigade 命令都会写回执。
- 所有者介导的交接与有界召回：交接由记忆所有者进行 lint 和路由。安全且有目标的笔记可能自动归档，模糊或有风险的笔记则等待审核。会话启动召回设有上限，vault project、search 和 propose 也受边界限制。
- 显式 dry-run 优先的 harness 投影：MCP 服务器、工具和技能在 Brigade 写入 harness 前会先预览。
- 基于结果的学习：Brigade 中的学习是基于结果的技能评分、晋升和从捕获的验证回执中回滚，而非自主反思式记忆学习。
二、使用方式 安装：pipx install brigade-cli 或 uv tool install brigade-cli，然后按照安装指南、QUICKSTART.md 操作，或将前 10 分钟和 docs/agents-guide.md 交给你的编码代理。 更新通道：稳定通道为已发布的 v0.27.0；预览通道使用 brigade update --channel beta 获取 0.28.0.devYYYYMMDD 的 wheel 包。 执行模型：Brigade 是本地文件优先的控制平面，除非命令或操作者拥有的调度器启动，否则不会运行任何东西。可选的 serve 命令（brigade center serve、brigade runs serve、brigade fleet serve）会在前台保持运行，直到手动停止。调度保持外部化，除了可选的操作者拥有、目标范围内的 care 注册（brigade care install）。 数据存储：工作账本为机器本地 JSON，不是分布式任务数据库。可选的 fleet hub 会聚合运行事件并仲裁仓库认领，其看板可展示外部 harness 会话，但本地日志保持权威。
三、适用场景 适合需要在多个 AI 编程代理工具（Claude Code、Codex、Cursor、VS Code、OpenCode 等）之间统一管理 MCP 服务器、工具、技能和记忆的开发者或团队。适合希望工作可追踪、结果可验证、记忆可携带、配置同步可控的场景。也适合需要跨仓库聚合就绪工作并组合并行安全波次（campaigns）的场景。
四、限制 Brigade 不是托管式记忆服务、自动发布机器人或完整的自主 fleet 运行时。除非操作者使用显式发送操作，否则它不会推送到 GitHub、发布包或发送聊天消息。普通运行没有硬性运行预算，除非声明了预算；即使声明，目前也只执行墙钟时间和工作分派上限，模型、工具、token 和成本维度保持观测状态，除非适配器拥有执行边界。Cloud registry 命令追踪的是其他提供商运行的工作。Center 和 fleet board 是只读的。外部活动观测为尽力而为。模糊或有风险的笔记需等待审核。安全且有目标的交接可在所有者策略下自动归档。已批准的 Grok Bot scout feed 仅在 --apply 后入队带标签的 GitHub issue。
五、名称冲突说明 这是来自 escoffier-labs/brigade 的 brigade-cli，不是已归档的 CNCF/Microsoft Kubernetes Brigade、Spinabot Brigade，也不是 2017 年那个后来变成 Nornir 的 Python 包。
六、项目标识 GitHub：escoffier-labs/brigade；网站：brigade.tools；PyPI：brigade-cli；命令：brigade。
