What problem does it solve?
OMX users need a lightweight, real-time view of system status and orchestration modes without building heavy dashboards. The HUD provides a two-layer approach: a built-in Codex status line for quick context and a dedicated CLI to surface OMX state details from .omx/state files, enabling faster triage and better situational awareness.
Core Features & Use Cases
- Layer 1: Codex built-in statusLine shows model, git branch, and context usage in real time, requiring no code changes.
- Layer 2: the omx hud CLI reads state files under .omx/state/ (ralph-state.json, ultrawork-state.json, autopilot-state.json, etc.) to surface orchestration modes and activity.
- Presets and configuration via hud-config.json allow tailoring the display for focused monitoring or full detail in development environments.
- Use cases include quick health checks, workflow visibility during development, and debugging multi-layer OMX orchestration.
Quick Start
Configure both layers with omx setup and start using omx hud to view real-time state from .omx/state files.