OpenRig rig status与rig ps区别全解：选对命令看对状态
【免费下载链接】openrigBuild your own network of agents from Claude Code, Codex and Pi: persistent teams with roles, shared context and owned work.项目地址: https://gitcode.com/GitHub_Trending/op/openrig
OpenRig 是把 Claude Code 和 Codex 装进同一个系统协同工作的多智能体运行时。日常运维中用得最多的两个状态查看命令就是rig status和rig ps——但一个查"系统健康"，一个查"团队干活"，用错了会白白浪费排查时间。这篇文章用 3 张对比表和几个常用组合，把两者的区别与选用场景一次讲清楚。
一眼看懂：rig status 与 rig ps 的区别
| 维度 | rig status | rig ps |
|---|---|---|
| 一句话定位 | 30 秒系统健康快检 | 每个 rig 与 agent 的详细花名册 |
| 关注点 | daemon / kernel / 摘要 | 节点级状态、活动、上下文占用 |
| 输出形态 | 几行人话摘要 | 表格（rig 级 / 节点级两层） |
| 机器可读 | 不支持--json | 支持--json/--fields/--filter |
| 典型问题 | "系统活着吗？" | "每个 agent 在干什么？" |
rig status的实现仅百余行（status.ts），设计哲学非常明确：只展示最关键的信号，不做无谓展开。
rig status 看什么：30 秒系统健康快检
rig status是面向人的摘要命令，一次输出按顺序回答 4 个问题 🩺：
- daemon 活着吗？——若已停止，还会说明上次是干净关机还是崩溃退出；
- kernel 就绪了吗？——kernel 就绪度是独立于 daemon 健康的单独信号；
- 哪个工作区根目录生效？——显示当前实际路径及来源（默认值还是覆盖值）；
- 各 rig 快照有多新鲜？——附带 cmux 终端复用可用性。
如果还没有任何 rig 在运行，它会直接给出下一步提示：用rig up <rig-spec>启动。完整说明见 cli-reference.md。
适用场景
- 刚拉起 rig，先确认环境是否健康
- agent 行为异常，先判断是不是 daemon 挂了
- 出现 "stale" 报错时，核对快照时间
rig ps 看什么：每个 agent 座位的状态
如果说rig status是"体检"，rig ps就是"花名册 + 工作看板" 🎯。默认列包括RIG、NODES、RUNNING、ACTIVE、WORK、ATTN、STATUS、LIFECYCLE、UPTIME、SNAPSHOT。其中ATTN列特别重要：把所有需要人看一眼的座位（需要输入、被阻塞、启动出错）汇总成一个数字。
用 --nodes 下钻到座位级
rig ps --nodes把某个 rig 展开成逐座位清单：会话状态、启动状态、活动状态（running / needs_input / idle）、上下文占用等。LIFECYCLE与ACTIVITY两列还能并排对比"启动时状态"与"实时运行状态"，排查卡顿时非常顺手。
常用组合速查
| 命令 | 看什么 |
|---|---|
rig ps | 所有活跃 rig 概览 |
rig ps --nodes --rig <name> | 指定 rig 的座位明细 |
rig ps --nodes -A | 跨 rig 的完整节点清单 |
rig ps --summary | 只要聚合计数，快速巡检 |
rig ps --filter lifecycleState=attention_required | 只筛出需要关注的座位 |
rig ps --json | 机器可读输出，适合脚本 |
官方完整规格在 cli-reference.md，数据结构定义见 ps.ts。
怎么选：3 个场景 3 秒定
| 场景 | 用哪个 |
|---|---|
| 启动后确认"就绪了吗" | rig status |
| "卡住了吗？""谁等我" | rig ps --nodes |
| 多 rig 故障排查 | 先rig status，再rig ps --nodes -A |
官方文档推荐的排查组合是：rig status看 daemon + kernel，再用rig ps --nodes --rig <name>看座位就绪度（见 getting-started.md）。遇到疑难杂症可继续查阅 help.md。
在 TUI 里看全队状态
命令输出不够直观时，OpenRig 自带 TUI 能一屏看完整个团队：每个座位的上下文占用、活动状态和协作边关系，一眼定位谁在忙、谁在等 📊。
延伸阅读
- CLI 完整参考：docs/as-built/cli-reference.md
- 上手指南：docs/reference/getting-started.md
- 演示 rig 拓扑：demo/rig.yaml、demo/README.md
- 命令实现源码：status.ts、ps.ts
【免费下载链接】openrigBuild your own network of agents from Claude Code, Codex and Pi: persistent teams with roles, shared context and owned work.项目地址: https://gitcode.com/GitHub_Trending/op/openrig
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
