hud

Display OMX orchestration status with a two-layer heads-up display.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/gtpgg1013/claude-skills-collection --skill hud-gtpgg1013
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hud
Source: https://github.com/gtpgg1013/claude-skills-collection/tree/main/skills/agents/hud
Command: npx skills add https://github.com/gtpgg1013/claude-skills-collection --skill hud-gtpgg1013

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OMX HUD provides a concise, two-layer visibility layer for OMX, enabling you to monitor and configure orchestration without digging through logs.

Core Features & Use Cases

  • Two-layer HUD: Layer 1 shows Codex-style status_line in the CLI, Layer 2 reads and displays OMX orchestration state from .omx/state files.
  • Quick commands and presets: omx hud with --watch, --json, and presets like minimal, focused, and full for different detail levels.
  • Setup and troubleshooting: runs omx setup to configure layers and provides guidance for common issues.

Quick Start

Run omx setup to configure both layers and then use omx hud to view the current state.

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 status in the CLI?

To monitor OMX orchestration status in the CLI, run omx setup to initialize the Codex status_line and state files, then use omx hud to display the two-layer heads-up view of your workflow.

What is a two-layer HUD for workflow monitoring?

A two-layer HUD for workflow monitoring displays a Codex-style status_line in the CLI as Layer 1, while Layer 2 reads and presents OMX orchestration state from .omx/state files.

Do I need to configure ~/.codex/config.toml to use OMX HUD?

Yes, you need to configure ~/.codex/config.toml for Layer 1 Codex status_line setup, and the omx setup routine initializes these defaults along with Layer 2 .omx/state files automatically.

Can I view OMX pipeline state in JSON format?

Yes, you can view OMX pipeline state in JSON format by running omx hud with the --json flag, which outputs the orchestration state data for integration or programmatic access.

What's the best way to watch live OMX Ralph loop state changes?

The best way to watch live OMX Ralph loop state changes is using the omx hud command with the --watch flag, which continuously refreshes the orchestration status display.

Why is my OMX HUD not displaying orchestration state?

If your OMX HUD is not displaying orchestration state, you likely missed the omx setup routine which initializes the required Layer 1 Codex configuration and Layer 2 .omx/state files.