安裝
npm install --global @escoffier-labs/[email protected]
brigade setup適合誰
- 適合同時使用多個編碼 agent 的開發者:在多個 harness(例如不同時刻使用不同的編碼 agent)之間切換時,希望工具與記憶保持同步、所有工作共用一份記錄,而不是每個工具各記一份、狀態互不相通。官方將其描述為可在任何地方執行編碼 agent,並為工作保留一份記錄。
- 它以 CLI 形式提供:agent 從共享記錄認領就緒工作,記憶與技能經 MCP 供給 harness。適合願意在命令列中管理 agent 工作狀態、並用 MCP 把能力串接到既有 agent 工具鏈的使用者。
- 工作記錄以本機檔案保存、不需要常駐程式(daemon),適合希望工作資料留在自己機器上、不想額外執行背景服務的使用者;是否支援多人協作或遠端部署,官方未說明。
- 使用前提: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,其他版本與升級方式未確認;認領之外如何新增工作、檢視全部工作或寫入記憶與技能,官方現有資訊未涵蓋;納入日常工作流程前建議先小規模試用,確認行為符合預期後再擴大使用範圍。