One Roof：在 Mac 集中管理 AI 程式開發代理

白話說明：One Roof 是做什麼用的？

One Roof 網站提供產品介紹、示範與 Mac 應用程式下載。安裝後，你可以在同一個地方管理 Claude Code、Codex、Gemini CLI、Kimi、Antigravity 等 AI 程式開發代理，也能開啟一般 Shell。

它像是代理工作的管理台：各代理仍執行自己的真實命令列工具，你負責看進度、回答問題與審查成果。適合把規劃、實作和程式碼審查交給不同代理，或同時維護多個儲存庫的開發者。

先看哪些工作正在等你決定

Inbox 將不同工作階段的請求集中起來，把卡住的工作排在前面，並保留代理原本提供的選項。你可以在收件匣回覆，也可以直接進入終端機操作；核准仍由使用者決定。

Sessions 顯示狀態、代理、帳號與資料夾。背景服務 roofd 讓執行中的工作階段在關閉應用程式後繼續運作。Home 彙整夜間失敗和後續步驟；History 可搜尋重要事件與你的決定，保留 30 天，方便事後追查處理過程。

Loops：依檢查結果重複工作

在 Loops 指定儲存庫、代理、目標、檢查命令及上限。先測試命令，並查看首次執行預覽，確認「完成」真的有可判斷的條件，例如測試全部通過。

系統先執行檢查；已通過就不啟動代理。需要處理時，代理在獨立 Git worktree 內工作，每輪結束後重新檢查。成功，或達到輪數、時間與重複失敗限制時停止。成果等待你審查，循環不會自行 push、合併或部署。

內建循環預設關閉。想在應用程式關閉後依排程執行，必須啟用排程設定並讓 Mac 保持喚醒。設定與核准流程可查看官方 Loops 說明。

相容條件與第一次使用

官方條件是 Apple silicon Mac、macOS 14 以上、Git，以及至少一個已安裝並完成驗證的代理 CLI。

1. 從 Releases 下載 ZIP，解壓縮後將 One Roof 移到「應用程式」。
2. 完成設定、允許 roofd，並選擇放置程式碼儲存庫的資料夾。
3. 按 ⌘N 描述任務，選代理與儲存庫，再按 ⌘Return 啟動。
4. 出現問題時用 ⌘I 開啟 Inbox 回覆；完成後檢查變更與結果，再決定是否接受。

正確理解資源用量和記憶體保護

Resources 顯示工作階段及程序樹的 CPU、記憶體用量，提供最近 10 分鐘圖表。預設 1 GB 警告、2 GB 終止的保護針對承載工作階段的程序本身，並不是所有子程序總用量的上限；環境設定也能改變門檻。

因此要一起觀察總用量和保護指示，不能只用是否觸發門檻判斷整組工作的資源壓力。

免費範圍、權限與檔案存取

2026 年 11 月 5 日查核時，應用程式免費開源，採 MIT 授權。代理訂閱、API 與託管模型費用仍使用你的帳號計算；循環、選用審查與評測也可能消耗額度。免費應用程式沒有附帶通用模型用量。

新安裝時各代理從 Manual 模式開始。其他模式因 CLI 而異，自訂啟動參數可能覆蓋設定。請選程式碼專用資料夾，因為代理能讀取其下內容。本機介面不代表所有連接的模型都離線運作，資料處理條件仍須依服務分別確認。

選用整合、共用規則與目前限制

Linear 專案功能需要自己的 API 金鑰。OpenCode、Goose 可使用自有憑證與預算預留上限連接託管模型。選用小型本機模型協助標籤與解釋，不等於所有程式開發推論都在本機進行。

roof 工具包協助統一工作目錄與共用規則；可用 roof install --dry-run 預覽安裝，再以 roof doctor 檢查設定。官方明確將 Evals 標為草稿，應視為仍在完善的功能。

常見問題

One Roof 免費是否也包含模型用量？

免費的是應用程式。代理帳號、API 呼叫與模型額度仍遵循各自條件，沒有無限模型使用量。

哪些 Mac 可以執行，支援 Windows 嗎？

公開要求為 Apple silicon 與 macOS 14+。本次未核實 Windows/Linux 圖形介面或 Intel Mac 版本。

支援哪些 AI 程式開發代理？

Claude Code、Codex、Gemini CLI、Kimi、Antigravity 和一般 Shell。OpenCode、Goose 託管工作階段需額外設定。

官方資源與開發者支援

• 原始碼與版本下載：查看專案、Releases 與實作。
• 首次使用指南：完成設定及第一個工作階段。
• GitHub 問題回報：提交錯誤與改進建議。