OpenRig首跑实录：rig setup --dry-run 先看计划再落地，安全变更你的机器

OpenRig首跑实录rig setup --dry-run 先看计划再落地安全变更你的机器【免费下载链接】openrigMulti-agent harness that runs Claude Code and Codex together as one system项目地址: https://gitcode.com/GitHub_Trending/op/openrigOpenRig 是一个多智能体运行框架Multi-agent harness能把 Claude Code 和 Codex 装进同一个 rig当成一个团队统一管理。它的第一次上手有一个很讨喜的设计rig setup --dry-run会先把「这台机器要发生什么」完整打印给你看但一个字节都不会改。本文用一条真实的首跑路径带你安全地变更你的机器。为什么首跑要先看 dry-run 计划OpenRig 不是装完就跑的轻量脚本它会往你的机器里写入一批运行状态和运行时配置信任设置、hooks、工作区文件。对新手来说最大的顾虑就是它到底动了我的什么。好消息是OpenRig 把这件事做成了可预演的dry-run 模式零副作用rig setup --dry-run只生成计划不做任何变更变更清单透明输出里会列出 OpenRig 可能修改的每个配置文件路径和用途每一步有状态OK / APPLIED / WARN / FAIL失败还会给出 Why 和 Fix 提示。这套逻辑就写在 setup.ts 里dry-run 分支会为每个步骤生成Dry run: xxx would be attempted的跳过记录直接返回不触发任何安装动作。一步安装把 OpenRig CLI 装到你的终端环境要求很简单详见 README.md依赖要求Node.js20 / 22 / 24Apple 芯片的 Mac 请用 22tmux必须系统macOS 或 Linux暂不支持原生 Windows然后全局安装npm install -g openrig/cli装完立即执行首跑的关键一步rig setup --dry-run此时你会看到一份「计划书」哪些步骤会在正式执行时被尝试、会触碰哪些文件。机器还没有被改动任何东西——这就是 OpenRig 安全变更哲学的起点。dry-run 计划里都有什么核心core配置包含 9 个步骤按顺序执行brew— macOS 上检查 Homebrewtmux、cmux 的安装通道tmux_install— 探测或安装 tmuxcmux_install— 安装并启用 cmux 的自动化 socket 控制macOS 特有claude_install / claude_auth— 安装 Claude Code 并确认已登录codex_install / codex_auth— 安装 Codex 并确认codex login状态tmux_config— 在~/.tmux.conf写入带# OpenRig managed block标记的管理块开启鼠标、加大滚动历史verify— 汇总检查失败则提示你跑rig doctor诊断另有两个可选开关值得知道rig setup --full --dry-run额外预览 jq、gh 等工位工具的规划rig setup --dry-run --json输出机器可读的 JSON 计划方便你交给自己的 agent 去审阅。落地清单OpenRig 到底会改你机器的哪些文件看过计划再执行所以先明确「落地」会发生什么。rig setup正式执行时可能修改的位置摘自 README.md 的变更披露表文件用途~/.tmux.conf追加 OpenRig 管理块鼠标 滚动历史~/.claude.json预信任受管工作区、标记 Claude 引导完成.claude/settings.local.json工作区内上下文收集器 statusLine 配置.mcp.json工作区内Claude MCP 运行时资源~/.codex/config.tomlCodex 预信任与运行时资源片段~/.config/cmux/settings.jsonmacOScmux socket 控制切到 automation 模式官方建议首跑前备份相关配置文件。OpenRig 自己也强调--dry-run只预演 setup不预演之后每次启动的全部副作用所以这份披露表值得逐行读一遍。确认没问题后执行正式落地rig setup输出格式与 dry-run 一致只是状态从SKIP变成了真实的OK / APPLIED。如果某一步 FAIL直接按输出的 Fix 提示处理或运行rig doctor拿到完整诊断。首跑实录从 setup 到团队跑起来setup 完成后OpenRig 会打印一条「黄金路径」引导你继续定义在 setup.ts 的goldenPathNextSteps。最短跑通路径cd /path/to/your/repository rig up first-project --cwd . # 启动 owner checker 两个 Codex 座位 rig ps --nodes --rig first-project # 检查座位就绪状态 rig tui --shared # 进入共享仪表盘first-project是内置的两座位起步 rig。如果你想要更大的团队可以看 demo/rig.yaml 这类示例 rig 的编排方式rig specs ls # 浏览内置 rig 库 rig specs preview conveyor --kind rig如果你更习惯图形界面OpenRig 还提供rig ui的浏览器视图。先点击侧边栏的 demo rig 加载拓扑再在拓扑图上点击 lead 座位的 CMUX 按钮直接打开编排者终端最后给 owner 一个有边界的任务就能收到「实现 复核」的完整闭环rig send dev-ownerfirst-project 实现一个有边界的改动完成后让 dev-check 复核并回报结果。完整的就绪检查、任务边界写法与恢复流程见 docs/reference/getting-started.md。常见问题Qdry-run 会安装任何东西吗不会。dry-run 分支只生成计划步骤记录全部标记为 skipped不调用任何安装命令测试用例也专门锁定了这一点见 packages/cli/test/setup.test.ts。Qsetup 失败了一半怎么办输出会明确标出 FAIL 的步骤和原因。跑rig doctor做系统体检修完再重跑rig setup——步骤是可重入的tmux 管理块会用标记替换而不是重复追加。Q它对权限有多激进默认不开 YOLOacceptEdits级别的默认配置也会如实打印在披露列表里想要更宽或更窄的权限需要通过rig setup --policy显式记录你的选择或者让你的 agent 按 docs/reference/getting-started.md 配置权限。小结OpenRig 首跑的安全感来自一个朴素的原则先给计划再给变更。rig setup --dry-run让你在不付出一字节的前提下看清 9 个步骤的意图变更披露表让你看清它碰过的每个文件rig doctor让你在出问题时有明确的诊断入口。看完计划、备份配置、正式 setup再沿黄金路径把first-project跑起来——你的多智能体团队就正式开工了。【免费下载链接】openrigMulti-agent harness that runs Claude Code and Codex together as one system项目地址: https://gitcode.com/GitHub_Trending/op/openrig创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考