hud

Display OMX HUD state and configuration from .omx/state files.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/KYRIE66nb/codex-omx-public-config --skill hud-kyrie66nb
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hud
Source: https://github.com/KYRIE66nb/codex-omx-public-config/tree/main/home/.agents/skills/hud
Command: npx skills add https://github.com/KYRIE66nb/codex-omx-public-config --skill hud-kyrie66nb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Show or configure the OMX HUD to provide a quick, at-a-glance status view of runtime states and modes.

Core Features & Use Cases

  • Two-layer HUD: Layer 1 integrates with Codex built-in status_line and is configured via the ~/.codex/config.toml file; Layer 2 is the omx hud CLI that reads .omx/state files to display real-time orchestration state (ralph, ultrawork, autopilot, team, pipeline, ecomode) and keeps a persistent HUD configuration.
  • Use Case: You want to monitor OMX runtime states during development or deployment to verify correct state transitions and contextual awareness.
  • Setup: omx setup configures both layers and writes default hud settings to .omx/hud-config.json.

Quick Start

Run omx hud to activate and view the two-layer status HUD after ensuring the status_line is configured in ~/.codex/config.toml.

Frequently Asked Questions about hud

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor OMX runtime states during development?

You can monitor OMX runtime states by running the omx hud command, which reads .omx/state files to display real-time orchestration modes like autopilot, pipeline, and ecomode for quick situational awareness.

What is the two-layer HUD configuration for Codex CLI?

The two-layer HUD integrates Layer 1 with the Codex built-in status_line via ~/.codex/config.toml, and Layer 2 uses the omx hud CLI to read .omx/state files and display real-time orchestration state.

Do I need to write additional code to display the OMX HUD?

No, displaying the OMX HUD requires no additional coding. It works directly with your existing Codex CLI setup and .omx/state files to render and persist HUD settings.

How do I set up the OMX HUD configuration?

You can set up the OMX HUD by running omx setup, which configures both the Codex status_line layer and the omx hud CLI layer, writing default settings to .omx/hud-config.json.

Can I view OMX orchestration states like autopilot and pipeline in real-time?

Yes, the omx hud CLI reads .omx/state files to display real-time orchestration states including ralph, ultrawork, autopilot, team, pipeline, and ecomode directly in your terminal.