用途:OMX HUD 用于显示或配置 OMX 的双层状态栏,帮助用户实时了解 Codex 会话中的编排状态。
主要能力:第一层是 Codex 内置 statusLine,在 TUI 底部实时显示模型、git 分支和上下文用量,通过 ~/.codex/config.toml 中的 [tui] status_line 配置,无需写代码。第二层是 omx hud CLI 命令,读取 .omx/state/ 下的状态文件,展示 OMX 特有的编排状态,包括 ralph、ultrawork、autopilot、team、pipeline、ecomode 和 turns。
使用方式:常用命令有 omx hud(显示当前 HUD)、omx hud --watch(每秒轮询实时更新)、omx hud --json(输出原始状态供脚本使用)、omx hud --preset=minimal/focused/full(选择预设)。omx setup 会自动配置两层:向 ~/.codex/config.toml 添加 [tui] status_line,并写入 .omx/hud-config.json,默认预设为 focused。若 HUD 或状态栏变化未出现,重启一次 Codex CLI。
配置与状态文件:HUD 配置存于 .omx/hud-config.json,如 {"preset": "focused"}。第二层读取 .omx/state/ 下的 ralph-state.json、ultrawork-state.json、autopilot-state.json、team-state.json、pipeline-state.json、ecomode-state.json、hud-state.json,以及 .omx/metrics.json 的轮次计数。颜色编码:绿色正常,黄色警告(ralph 超过最大值 70%),红色严重(超过 90%)。
适用场景:需要监控 Codex 编排工作流运行状态、轮次和活动时间的用户。
限制:第一层需 Codex CLI v0.101.0+;omx hud 显示“No active modes”在无工作流运行时属预期,需启动明确请求的受支持工作流(如 $autopilot 或 $ultragoal)后再查看。