hud

Display OMX orchestration state and configuration via the omx hud CLI.

1|Updated Mar 17, 2025
One-click install
npx skills add https://github.com/ozby/node-pubsub --skill hud-ozby
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hud
Source: https://github.com/ozby/node-pubsub/tree/main/.codex/skills/hud
Command: npx skills add https://github.com/ozby/node-pubsub --skill hud-ozby

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OMX HUD provides real-time visibility into the OMX orchestration state and a straightforward way to configure the two-layer display, reducing debugging time and context switching.

Core Features & Use Cases

  • Layer 1 shows a Codex built-in status line with model, git branch, and context remaining; Layer 2 exposes the omx hud CLI to reveal orchestration state such as ralph, ultrawork, autopilot, team, pipeline, and ecomode.
  • Setup and configuration are centralized via omx setup, which writes the hud-config.json and updates the status_line configuration for rapid deployment across environments.
  • Quick Start enables immediate monitoring and customization of the HUD through presets (minimal, focused, full) and live state viewing.

Quick Start

Run omx hud to display current HUD state and switch presets as needed.

Frequently Asked Questions about hud

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

FAQPage Schema
How do I view OMX orchestration state and configuration in real-time?

To view OMX orchestration state in real-time, run the omx hud CLI command, which reads state files from the .omx/state directory and displays active orchestration processes like ralph, ultrawork, and autopilot.

What is the two-layer display architecture for OMX status monitoring?

The two-layer architecture combines a built-in status line showing model, git branch, and context remaining on Layer 1, with Layer 2 exposing the omx hud CLI to reveal deeper orchestration state and telemetry data.

How do I configure and deploy OMX HUD presets across different environments?

Configure and deploy OMX HUD presets across environments by running omx setup, which writes the hud-config.json file and updates the status_line configuration for rapid deployment in local development and production setups.

Can I customize the OMX HUD display using minimal, focused, or full presets?

Yes, you can customize the OMX HUD display using minimal, focused, and full presets, allowing immediate monitoring and customization of orchestration state visibility based on your specific debugging needs.

Does OMX HUD work with both local development environments and production setups?

OMX HUD works across both local development environments and production setups, reading state files and configurations to provide orchestration visibility wherever OMX state files and config define display presets.

Why does my OMX HUD status line show incorrect orchestration state during debugging?

Incorrect OMX HUD orchestration state during debugging often results from outdated state files in the .omx/state directory or a misconfigured hud-config.json file that requires re-running omx setup to update.