hud

Display OMX HUD status and orchestration state for real-time monitoring.

Updated Feb 21, 2026
One-click install
npx skills add https://github.com/byonk19-svg/rt-scheduler --skill hud-byonk19-svg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hud
Source: https://github.com/byonk19-svg/rt-scheduler/tree/main/.codex/skills/hud
Command: npx skills add https://github.com/byonk19-svg/rt-scheduler --skill hud-byonk19-svg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Show OMX HUD status and orchestration state for real-time monitoring.

Core Features & Use Cases

  • Layer 1: Codex built-in statusLine integration for a live footer with model, git branch, and context usage.
  • Layer 2: omx hud CLI that exposes orchestration state (ralph, ultrawork, autopilot, team, pipeline, ecomode) via a concise, readable display.
  • Presets and setup: hud-config.json presets and the omx setup flow to configure consistent visibility and defaults.
  • Troubleshooting and color coding help, guidance for healthy, warning, and critical states.

Quick Start

Install the OMX Codex CLI, run omx setup to configure the HUD, and then run omx hud to view the current 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 in real time?

You can monitor OMX orchestration state in real time by running the `omx hud` CLI command, which displays status for ralph, ultrawork, autopilot, team, pipeline, and ecomode modules. It reads Layer 2 state files from the `.omx` directory.

How do I configure a live status line footer with model and git branch details?

To configure a live status line footer, use the Codex built-in statusLine integration at Layer 1. It displays model information, git branch, and context usage, and can be set up consistently using `hud-config.json` presets via the `omx setup` flow.

What do the color codes mean when troubleshooting OMX HUD status?

OMX HUD color coding indicates system health: healthy states display normally, warning states signal potential issues, and critical states denote failures. This visual guidance helps operators quickly diagnose and troubleshoot orchestration problems.

Do I need to run setup before using the omx hud CLI for monitoring?

Yes, you should run `omx setup` first to configure the HUD visibility and defaults. This process generates `hud-config.json` presets and ensures the Layer 1 status line and Layer 2 state files integrate correctly.

Can I use OMX HUD for diagnostics across different orchestration layers?

Yes, OMX HUD is designed for developers and operators managing workflows across layers. It integrates Layer 1 status line configuration with Layer 2 `.omx` state files to provide consistent visibility and control for diagnostics and troubleshooting.