hud

Configure the OMX HUD status line for Codex CLI sessions using .omx state files and hud config.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/hotaq/Sprite_harmess --skill hud-hotaq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hud
Source: https://github.com/hotaq/Sprite_harmess/tree/main/.codex/skills/hud
Command: npx skills add https://github.com/hotaq/Sprite_harmess --skill hud-hotaq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you surface the live OMX orchestration state without digging through config files or hidden state, so you can see what the workspace is doing at a glance.

Core Features & Use Cases

  • Two-layer visibility: Uses the Codex built-in status line for real-time model, branch, and context information while also exposing OMX-specific orchestration state.
  • Operational monitoring: Shows active modes, turns, recent activity, pipeline stage, team workers, and other session signals for local development workflows.
  • Setup and troubleshooting: Guides configuration through omx setup, helps verify .omx state files and hud config, and supports quick diagnosis when the HUD does not appear.

Quick Start

Ask the assistant to show or configure the OMX HUD for this workspace and help you verify that the status line and local HUD state are enabled.

Frequently Asked Questions about hud

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

FAQPage Schema
How do I show live OMX orchestration status in my development workflow?

To show live OMX orchestration status, you need to configure the OMX HUD and status line. This two-layer display surfaces active modes, turns, and recent activity across Codex and OMX sessions without digging through hidden state files.

What do I need to set up the OMX HUD and status line?

Setting up the OMX HUD requires Codex CLI v0.101.0 or later for the status line, plus local .omx state files, hud config, and session metrics to render the complete two-layer orchestration display.

Can I monitor active team workers and pipeline stages locally with OMX?

Yes, you can monitor active team workers and pipeline stages locally. The OMX HUD provides operational monitoring of session signals, active modes, turn counts, and recent activity for local development workflows.

Why is the OMX HUD not appearing in my workspace?

If the OMX HUD is not appearing, your configuration likely needs troubleshooting. You must verify that .omx state files and hud config exist, and ensure the Codex CLI v0.101.0+ status line setup is correctly enabled for rendering.

How does the two-layer OMX visibility display work?

The two-layer OMX visibility works by using the Codex built-in status line for real-time model and branch information while simultaneously exposing OMX-specific orchestration state like pipeline stages and team workers in a local HUD.

Do I need Codex CLI to use OMX orchestration monitoring?

Yes, you need Codex CLI v0.101.0 or later to use OMX orchestration monitoring. The Codex CLI provides the built-in status line required to render the first layer of the two-layer HUD display.