One Roof：在 Mac 上统一管理 AI 编程智能体

通俗解释：One Roof 这个网站是干什么用的？

One Roof 的网站提供产品介绍、演示和 Mac 应用下载。安装应用后，你可以把 Claude Code、Codex、Gemini CLI、Kimi、Antigravity 等 AI 编程智能体放在同一个地方管理，也能打开普通 Shell 会话。

可以把它理解成编程代理的调度与值班台：代理仍运行各自真正的命令行工具，你负责查看进度、回答问题和审查结果。它适合已经使用编程代理、希望把规划、实现和代码审查分给不同代理的开发者，也适合同时维护多个代码仓库的人。

用统一收件箱处理等待中的问题

多开终端最容易遗漏的，是某个代理已经停下来等待批准。One Roof 的 Inbox 会汇总各会话的请求，把阻塞工作的问题放到前面，并显示代理原本提供的选项。你可以在这里回复，也可以直接进入终端操作，批准决定仍由你做出。

Sessions 为会话标明状态、代理、账号和目录。后台服务 roofd 让正在运行的会话在关闭应用界面后继续工作。Home 汇总夜间运行的错误与下一步，History 则以可搜索记录保留重要事件和你的决定，保存期为 30 天。

用 Loops 完成有检查、有上限的重复任务

如果你想“修复问题，直到测试通过”，可以在 Loops 中设置仓库、代理、目标、检查命令和运行限制。先测试检查命令，并查看首次运行预览，确认判断成功的条件确实有效。

One Roof 会先运行检查；已经通过时不会再启动代理。需要修改时，代理在独立 Git worktree 中工作，每轮完成后重新检查。任务成功，或达到轮数、时间、重复失败限制时停止。产出等待你审查，循环不会自行 push、合并或部署。

内置循环默认关闭。若要在应用关闭后按计划运行，需要启用定时运行，并保持 Mac 唤醒。具体设置与产出审批方式见官方循环任务说明。

从安装到启动第一个编程会话

官方要求 Apple silicon Mac、macOS 14 或更新版本、Git，以及至少一个已安装并完成身份认证的代理 CLI。

1. 从官方 Releases 下载 ZIP，解压后把 One Roof 放入“应用程序”。
2. 完成首次设置，允许 roofd 后台服务，选择存放代码仓库的项目文件夹。
3. 按 ⌘N 新建会话，写清任务目标，选择代理和仓库，再按 ⌘Return 启动。
4. 代理提问时按 ⌘I 打开 Inbox 回复。完成后检查改动和实际结果，再决定是否接受。

查看 CPU 和内存时，注意保护阈值的范围

Resources 展示会话及其进程树的 CPU、内存用量，并提供最近 10 分钟的图表。默认的 1 GB 警告、2 GB 终止阈值针对的是会话承载进程本身，并非限制所有子进程加起来的总内存；环境配置还可以改变阈值。

因此，应同时看进程树总用量和保护条，不能把“未触发保护”理解成整组代理进程占用一定很低。

免费范围、代理权限与代码数据边界

截至 2026 年 11 月 5 日核实，One Roof 应用免费开源，采用 MIT 许可。代理订阅、API 请求与托管模型费用仍由你的账号承担；循环轮次、可选审查和评测可能继续消耗额度。这里的免费不包含统一的模型套餐。

新安装时各代理默认使用 Manual 模式。其他权限模式的行为因 CLI 而异，自定义启动参数可能覆盖设置。请选只存放代码的项目目录，因为代理能够读取其下的文件。本地应用界面也不代表所有连接的模型都离线运行，具体账号与服务的数据条件需要分别核对。

Linear、共享规则和其他可选能力

Projects 的 Linear 连接需要你自己的 API Key。OpenCode、Goose 可以通过自有凭证和预算预留上限使用托管模型。可选的小型本地模型用于辅助生成标签与解释，不应据此理解为整个编程流程都在本地推理。

配套 roof 工具包用于统一工作目录、共享规则和相关上下文设置；可先用 roof install --dry-run 预览安装，再用 roof doctor 检查配置。Evals 被官方明确标为草稿，应按尚在完善的能力看待。

常见问题

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

免费的是应用本身。Claude Code、Codex 等代理账号，以及托管模型 API 的用量和费用仍按各自条件计算，不包含无限模型调用。

哪些 Mac 可以运行，支持 Windows 吗？

公开要求是 Apple silicon 和 macOS 14+。本次没有核实到 Windows、Linux 图形界面或 Intel Mac 构建，不应按跨平台桌面产品理解。

支持哪些 AI 编程智能体？

主要列出 Claude Code、Codex、Gemini CLI、Kimi、Antigravity 和普通 Shell。OpenCode、Goose 托管会话属于需要另行配置的可选路径。

官方资源与开发者支持

• 源码与版本下载：检查项目、查看 Releases 和实现细节。
• 首次使用指南：按官方步骤完成设置与第一场会话。
• GitHub 问题反馈：报告错误或提出改进建议。