mvschwarz/openrig

Multi-agent harness that runs Claude Code and Codex together as one system

這是什麼

OpenRig 是一個把多個 AI coding agent 收束成「團隊」的本機 multi-agent harness。README 的說法很直接：harness 包住模型，而 rig 包住多個 harness；你用 YAML 定義 agent 拓樸，再用一個指令啟動。它不是替代 Claude Code 或 Codex，而是把這些終端機裡各跑各的 agent，整理成可持續、可觀察、可恢復的一套系統：誰在跑、彼此如何連線、如何重啟後接回上下文、如何避免變成一堆難以管理的 terminal sprawl。架構上，它是基於 tmux 的 local daemon + CLI + TUI + MCP server，底層搭配 Hono HTTP daemon、domain services、SQLite、tmux 與 runtime adapters。

為什麼上榜

這個專案今天已有 3,005 stars、本期新增 624 stars，熱度來自一個很明確的痛點：開發者開始同時使用 Claude Code、Codex 等 coding agent，但真正麻煩的不是「叫一個 agent 做事」，而是把多個 agent 的工作流、狀態、權限與溝通管理好。OpenRig 的亮點在於把「多開幾個終端機」提升成可描述的 rig：可以預覽規格、啟動 seats、看拓樸圖與表格、把既有 tmux session 納管，甚至用 rig send、rig broadcast、rig chatroom 在 agent 之間傳遞訊息。它吸引人的地方不是單一模型能力，而是把 agent orchestration 落在開發者已熟悉的本機工具鏈上。

適合誰，可以拿來做什麼

OpenRig 適合已經在用 Claude Code 或 Codex、並且想把它們變成可重複工作流程的開發者或小團隊。典型情境包括：一個 owner agent 配一個 checker agent、Claude 與 Codex 混合分工、較大的 product squad、研究團隊、adversarial review，或把既有 session 納入同一個 dashboard。上手門檻不算低：README 明確要求 Node.js 22 或 24、tmux、macOS 或 Linux；原生 Windows 尚未支援，WSL2 也未測試。也要注意它會修改本機環境與 provider 設定，例如 trust settings、executable hooks、tmux 設定與 OpenRig instance state，因此更適合願意理解本機自動化邊界的使用者。

上手

README 提供了明確的安裝與 first run 路徑。建議先跑 dry-run，並閱讀它會改動哪些本機檔案；在 Apple silicon Mac 上，README 特別建議使用 Node.js 22。

npm install -g @openrig/cli
rig setup --dry-run

接著在目標 repository 中選擇 starter rig，先預覽，再以 plan 模式檢查，最後啟動並打開共享 TUI：

cd /path/to/your/repository
starter=first-project  # or first-project-claude or first-project-mixed
rig specs preview "$starter" --kind rig
rig up "$starter" --cwd . --plan
rig up "$starter" --cwd .
rig tui --shared

README 也提醒：只需要登入你實際要用的 provider；不用為了 OpenRig 同時準備 Claude Code 與 Codex。rig setup --dry-run 會預覽較完整的設定，而實際 rig setup 會檢查 harness 與 cmux。

README 重點摘要

• OpenRig 用 YAML RigSpec 描述 pods、edges 與 continuity policies，並透過 rig up 啟動 tmux sessions、harnesses、startup files 與 readiness checks。
• TUI 可查看 rigs、pods、seats、feeds 與 instance health；也能把既有 Claude Code / Codex tmux sessions 採納進 managed rig。
• 支援 rig down --snapshot 與以名稱 restore，讓多 agent 拓樸不只是一次性的終端機配置。
• 它會寫入本機狀態、provider integration、workspace files，包含 trust settings 與 executable hooks；正式套用前應先讀 README 的變更說明並備份相關檔案。
• Starter rigs 包含 first-project、first-project-claude、first-project-mixed、product-team、conveyor、implementation-pair、adversarial-review、research-team 與 secrets-manager。