hud

Display OMX runtime status across a two-layer HUD.

Updated Jan 4, 2026
One-click install
npx skills add https://github.com/YeaChan05/Remittance --skill hud-yeachan05
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hud
Source: https://github.com/YeaChan05/Remittance/tree/main/.codex/skills/hud
Command: npx skills add https://github.com/YeaChan05/Remittance --skill hud-yeachan05

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OMX runtime status across a two-layer HUD is hard to monitor manually. The HUD provides a unified view to simplify monitoring of OMX modes and orchestration state.

Core Features & Use Cases

  • Layer 1 - Codex Built-in StatusLine: Real-time footer showing model, git branch, and context usage, configured via [tui] status_line in ~/.codex/config.toml with zero code changes.
  • Layer 2 - OMX Orchestration HUD: The omx hud CLI reads .omx/state/ files to show current orchestration state (ralph, ultrawork, autopilot, team, pipeline, ecomode, hud-state) and reads .omx/hud-config.json for presets.
  • Setup & Presets: omx setup configures both layers; presets include minimal, focused, and full for different verbosity.

Quick Start

Run the setup to configure both layers, then run omx hud to view the current OMX status.

Frequently Asked Questions about hud

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

FAQPage Schema
How do I monitor OMX orchestration state files in real time?

You can monitor OMX orchestration state files by running the `omx hud` CLI, which reads `.omx/state/*.json` files to display current modes like ralph, ultrawork, and autopilot in a unified view.

What is the two-layer HUD for OMX runtime status?

The two-layer HUD combines the Codex built-in StatusLine for model and git branch context with an OMX Orchestration HUD for detailed state file visibility, simplifying real-time management and debugging.

How do I configure Codex StatusLine for OMX monitoring?

Configure Codex StatusLine for OMX monitoring by setting `[tui] status_line` options in `~/.codex/config.toml`, or run `omx setup` to automatically configure both HUD layers with zero code changes.

Can I customize the OMX HUD display using presets?

Yes, you can customize the OMX HUD display using presets like minimal, focused, and full. Set these verbosity presets via the optional `.omx/hud-config.json` file for Layer 2.

Do I need a config.toml file to use the OMX HUD?

You need `~/.codex/config.toml` for Layer 1 StatusLine and `.omx/state/*.json` files for Layer 2 orchestration data, but running `omx setup` configures both layers automatically.