hud
GitHub用于配置和展示 OMX HUD，包含 Codex TUI 状态栏及 CLI 命令查看编排状态。支持实时监控、预设显示及故障排查。
Trigger Scenarios
Install
npx skills add Yeachan-Heo/oh-my-codex --skill hud -g -y
SKILL.md
Frontmatter
{
"name": "hud",
"role": "display",
"scope": ".omx\/**",
"description": "Show or configure the OMX HUD (two-layer statusline)"
}
HUD Skill
The OMX HUD uses a two-layer architecture:
-
Layer 1 - Codex built-in statusLine: Real-time TUI footer showing model, git branch, and context usage. Configured via
[tui] status_linein~/.codex/config.toml. Zero code required. -
Layer 2 -
omx hudCLI command: Shows OMX-specific orchestration state (ralph, ultrawork, autopilot, team, pipeline, ecomode, turns). Reads.omx/state/files.
Quick Commands
| Command | Description |
|---|---|
omx hud |
Show current HUD (modes, turns, activity) |
omx hud --watch |
Live-updating display (polls every 1s) |
omx hud --json |
Raw state output for scripting |
omx hud --preset=minimal |
Minimal display |
omx hud --preset=focused |
Default display |
omx hud --preset=full |
All elements |
Presets
minimal
[OMX] ralph:3/10 | turns:42
focused (default)
[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
Setup
omx setup automatically configures both layers:
- Adds
[tui] status_lineto~/.codex/config.toml(Layer 1) - Writes
.omx/hud-config.jsonwith default preset (Layer 2) - Default preset is
focused; if HUD/statusline changes do not appear, restart Codex CLI once.
Layer 1: Codex Built-in StatusLine
Configured in ~/.codex/config.toml:
[tui]
status_line = ["model-with-reasoning", "git-branch", "context-remaining"]
Available built-in items (Codex CLI v0.101.0+):
model-name, model-with-reasoning, current-dir, project-root, git-branch, context-remaining, context-used, five-hour-limit, weekly-limit, codex-version, context-window-size, used-tokens, total-input-tokens, total-output-tokens, session-id
Layer 2: OMX Orchestration HUD
The omx hud command reads these state files:
.omx/state/ralph-state.json- Ralph loop iteration.omx/state/ultrawork-state.json- Ultrawork mode.omx/state/autopilot-state.json- Autopilot phase.omx/state/team-state.json- Team workers.omx/state/pipeline-state.json- Pipeline stage.omx/state/ecomode-state.json- Ecomode active.omx/state/hud-state.json- Last activity (from notify hook).omx/metrics.json- Turn counts
Configuration
HUD config stored at .omx/hud-config.json:
{
"preset": "focused"
}
Color Coding
- Green: Normal/healthy
- Yellow: Warning (ralph >70% of max)
- Red: Critical (ralph >90% of max)
Troubleshooting
If the TUI statusline is not showing:
- Ensure Codex CLI v0.101.0+ is installed
- Run
omx setupto configure[tui]section - Restart Codex CLI
If omx hud shows "No active modes":
- This is expected when no workflows are running
- Start a workflow (ralph, autopilot, etc.) and check again
Version History
- e94437f Current 2026-08-20 07:19
