适合谁
- 适合同时使用多个编码 agent 的开发者：在多个 harness（例如不同时刻使用不同的编码 agent）之间切换时，希望工具与记忆保持同步、所有工作共用一份记录，而不是每个工具各记一份、状态互不相通。官方将其描述为可在任何地方运行编码 agent，并为工作保留一份记录。
- 它以 CLI 形式提供：agent 从共享记录认领就绪工作，记忆与技能经 MCP 供给 harness。适合愿意在命令行中管理 agent 工作状态、并用 MCP 把能力接入既有 agent 工具链的用户。
- 工作记录以本地文件保存、不需要守护进程，适合希望工作数据留在自己机器上、不想额外运行后台服务的用户；是否支持多人协作或远端部署，官方未说明。
- 使用前提：npm 安装路线要求 Node.js 22 或更新版本以及 npm；环境不满足时，官方未提供其他安装方式，也未说明不同操作系统之间是否存在差异。
- 官方没有列出不适合的情况，也没有给出受支持的 harness 名单。接入前需确认你的 agent 客户端能否添加 stdio 方式的 MCP 服务器，这一点官方未替你说明；若你的工具链既不能运行 CLI 也不能接入 MCP，则暂时没有可确认的接入路径。
3 分钟完成第一次尝试
- 前提：备好 Node.js 22 或更新版本与 npm。官方说明使用中可能发送一次被动的版本请求（passive version request）作为遥测副作用，这是官方明示的网络副作用，属于使用前需要接受的前提，安装时应知悉；除此之外是否还有网络访问，现有信息未说明。
- 推荐主路径只有一条：用 npm 全局安装固定版本包，随后按官方步骤初始化：
npm install --global @escoffier-labs/[email protected]
brigade setup
- 触发第一次尝试：让 agent 执行
brigade work claim --next --actor codex，从共享记录认领一条就绪工作，这是官方展示的核心工作流。注意认领是"取走就绪工作"的动作，认领后这条工作在记录中的状态如何变化、能否撤销，官方未说明，请把它当作会影响记录的操作对待。
- 若暂不想让 agent 认领工作，可先在本地以 stdio 方式启动
brigade memory serve-mcp --stdio，把它作为 MCP 服务器接入 harness，观察能否经 MCP 读取 Brigade 的记忆与技能，这一步不涉及认领动作。
- 成功信号：agent 通过认领命令取到一条就绪工作，或 harness 经 MCP 读到 Brigade 的记忆与技能。brigade setup 的具体行为与成功输出官方未描述，若命令未达预期，先确认 Node.js 版本满足要求，再到官方仓库核对步骤。
使用案例
- 案例 1：让多个 agent 共用一份工作记录。场景：你同时使用不止一个编码 agent，希望"谁在做什么、做到哪一步"有一处统一记录，而不是散落在各自会话里，换一个工具就丢一次上下文。发起：完成安装与 brigade setup 后，在任务开始时让 agent 执行
brigade work claim --next --actor codex。工作流：work claim，agent 从共享记录认领一条就绪工作。可以期待：该条工作被认领，记录保存在本地文件且无守护进程；认领后记录如何更新、如何查看全部工作，官方未说明，目前能确认到认领这一步。
- 案例 2：把记忆与技能供给 harness。场景：希望 harness 处理任务时能使用 Brigade 维护的记忆与技能，而不是每个工具各自维护一份、互相不通。发起：以 stdio 方式启动
brigade memory serve-mcp --stdio，把它作为 MCP 服务器接入 harness。工作流：memory serve-mcp，Brigade 经该服务器向 harness 暴露记忆与技能。可以期待：harness 能经 MCP 读取记忆与技能；你的客户端如何登记 stdio MCP 服务器、接入后有哪些可调用接口，官方未说明，需按所用 harness 的常规方式接入后再验证。
使用边界
- 网络访问：官方说明可能发送一次被动版本请求作为遥测，这一点由官方在说明中主动披露；除此之外是否还有网络访问没有说明，因此不能把它当作完全离线的本地工具。
- 文件与副作用：工作记录保存在本地文件，无守护进程；认领会从共享记录取走就绪工作，能否撤销未说明；安装与 brigade setup 对系统做了哪些改动，官方未逐项列出。
- 运行环境与客户端：npm 路线要求 Node.js 22 或更新版本与 npm；受支持的 harness 名单未确认，你的 harness 是否可用需自行验证。
- 版本与其他：安装命令固定为 0.30.0，其他版本与升级方式未确认；认领之外如何新增工作、查看全部工作或写入记忆与技能，官方现有信息未覆盖；纳入日常工作流前建议先小范围试用，确认行为符合预期后再扩展使用范围。