hud

Configure and monitor the OMX HUD for real-time runtime status.

1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/Linnanli/xClaw --skill hud-linnanli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hud
Source: https://github.com/Linnanli/xClaw/tree/main/.codex/skills/hud
Command: npx skills add https://github.com/Linnanli/xClaw --skill hud-linnanli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The OMX HUD provides a two-layer status display that keeps model state, context, and orchestration data visible at all times, reducing context switching and mental load.

Core Features & Use Cases

  • Layer 1: Codex built-in StatusLine shows real-time model, git branch, and context usage.
  • Layer 2: OMX hud CLI exposes orchestration state (ralph, ultrawork, autopilot, team, pipeline, ecomode, turns) and reads .omx/state files.
  • Use Case: Operators can quickly verify system health and switch presets to focus on the most relevant information.

Quick Start

To begin, run omx hud to view the current HUD and edit the default preset in .omx/hud-config.json.

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 from the CLI?

To monitor OMX orchestration state, run the `omx hud` CLI command to visualize real-time status for workflows like ralph, ultrawork, autopilot, and pipeline. It reads live state files from the `.omx/state` directory to display runtime data at a glance.

What is a two-layer status line display for developer workflows?

A two-layer status line display combines Codex built-in StatusLine data, showing real-time model and git branch usage, with an OMX orchestration layer exposing context and pipeline state, reducing context switching and mental load for operators.

How do I configure HUD presets to focus on specific runtime information?

To configure HUD presets, edit the `.omx/hud-config.json` file to define display rules. Switching presets allows operators to quickly verify system health and focus on the most relevant orchestration data.

Does the OMX HUD require specific state files to function?

Yes, the OMX HUD requires state files located in the `.omx/state` directory to function. It reads these orchestration state files to render real-time visibility for workflows like team, ecomode, and turns.

Can I use the OMX HUD to check context usage and git branch status?

Yes, you can use the OMX HUD to check context usage and git branch status. Layer 1 utilizes the Codex built-in StatusLine to show real-time model state, git branch, and context usage directly in your workflow.