HUD 技能

OMX HUD 采用双层架构：

1. 第 1 层——Codex 内置 statusLine：实时 TUI 页脚，显示模型、Git 分支和上下文使用情况。通过 ~/.codex/config.toml 中的 [tui] status_line 进行配置。无需编写任何代码。

2. 第 2 层——omx hud CLI 命令：显示 OMX 特定的编排状态（ralph、ultrawork、autopilot、team、pipeline、ecomode、turns）。读取 .omx/state/ 文件。

快速命令

命令	说明
omx hud	显示当前 HUD（模式、轮次、活动）
omx hud --watch	实时更新显示（每 1 秒轮询一次）
omx hud --json	输出用于脚本编写的原始状态
omx hud --preset=minimal	最小化显示
omx hud --preset=focused	默认显示
omx hud --preset=full	显示所有元素

预设

minimal

[OMX] ralph:3/10 | turns:42

focused（默认）

[OMX] ralph:3/10 | ultrawork | team:3 workers | turns:42 | last:5s ago

full

[OMX] ralph:3/10 | ultrawork | autopilot:execution | team:3 workers | pipeline:exec | turns:42 | last:5s ago | total-turns:156

设置

omx setup 会自动配置这两层：

• 将 [tui] status_line 添加到 ~/.codex/config.toml（第 1 层）
• 使用默认预设写入 .omx/hud-config.json（第 2 层）
• 默认预设为 focused；如果 HUD/statusline 的更改未显示，请重启一次 Codex CLI。

第 1 层：Codex 内置 StatusLine

在 ~/.codex/config.toml 中配置：

[tui]
status_line = ["model-with-reasoning", "git-branch", "context-remaining"]

可用的内置项…