Menu
Show or configure the OMX HUD (two-layer statusline)
[OMX] Bounded best-practice research wrapper using official/upstream evidence first
[OMX] Strict autonomous loop: $deep-interview -> $ralplan -> $ultragoal (+ $team if needed) -> $code-review -> $ultraqa
Socratic deep interview with mathematical ambiguity gating before execution
Parallel execution engine for high-throughput task completion
Run a comprehensive code review
Adversarial dynamic e2e QA workflow - generate hostile scenarios, test, verify, fix, report, and clean up
| name | hud |
| description | Show or configure the OMX HUD (two-layer statusline) |
| role | display |
| scope | .omx/** |
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_line in ~/.codex/config.toml. Zero code required.
Layer 2 - omx hud CLI command: Shows OMX-specific orchestration state (ralph, ultrawork, autopilot, team, pipeline, ecomode, turns). Reads .omx/state/ files.
| 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 |
[OMX] ralph:3/10 | turns:42
[OMX] ralph:3/10 | ultrawork | team:3 workers | turns:42 | last:5s ago
[OMX] ralph:3/10 | ultrawork | autopilot:execution | team:3 workers | pipeline:exec | turns:42 | last:5s ago | total-turns:156
omx setup automatically configures both layers:
[tui] status_line to ~/.codex/config.toml (Layer 1).omx/hud-config.json with default preset (Layer 2)focused; if HUD/statusline changes do not appear, restart Codex CLI once.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
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 countsHUD config stored at .omx/hud-config.json:
{
"preset": "focused"
}
If the TUI statusline is not showing:
omx setup to configure [tui] sectionIf omx hud shows "No active modes":