hud

Display and configure OMX HUD status from .omx/state files.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OMX HUD provides real-time visibility into orchestration state and configuration, enabling faster debugging and smoother operations without interrupting your workflow.

Core Features & Use Cases

  • Layer 1 - Codex built-in statusLine: Real-time TUI footer showing model, git branch, and context usage. Configured via [tui] status_line in ~/.codex/config.toml. Zero code required.
  • Layer 2 - OMX HUD orchestration: CLI command that reads and displays current orchestration state from .omx/state/ files.
  • Use Case: Monitor active modes such as ralph, ultrawork, autopilot, team, pipeline, ecomode, and turns during active development or production runs.

Quick Start

Run omx setup to configure both layers and start the status display.

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 CLI command to read and display active modes from the .omx/state/ files, or by configuring the built-in TUI status line footer.

What status information does the Codex TUI footer display?

The Codex TUI status line footer displays the current model, git branch, and context usage in real time. It is configured via the status_line setting in the ~/.codex/config.toml file.

How do I set up the OMX HUD status display?

To set up the OMX HUD status display, run the omx setup command. This configures both the Codex built-in TUI footer and the OMX HUD orchestration CLI to load state data into your active context.

Do I need the Codex CLI tooling to view the OMX HUD status?

Yes, viewing the OMX HUD status requires Codex CLI tooling and a configured HUD setup. These prerequisites are necessary to load the orchestration state data from your .omx/state files.

Which orchestration modes can I monitor using the OMX HUD?

Using the OMX HUD, you can monitor active orchestration modes such as ralph, ultrawork, autopilot, team, pipeline, ecomode, and turns during active development or production runs.

Can I view orchestration state without writing custom code?

Yes, you can view orchestration state without writing custom code. Layer 1 uses the zero-code required Codex built-in statusLine, while Layer 2 reads directly from .omx/state/ files.