hud

Display OMX orchestration state from .omx/state files via a two-layer HUD.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OMX users need a lightweight, real-time view of system status and orchestration modes without building heavy dashboards. The HUD provides a two-layer approach: a built-in Codex status line for quick context and a dedicated CLI to surface OMX state details from .omx/state files, enabling faster triage and better situational awareness.

Core Features & Use Cases

  • Layer 1: Codex built-in statusLine shows model, git branch, and context usage in real time, requiring no code changes.
  • Layer 2: the omx hud CLI reads state files under .omx/state/ (ralph-state.json, ultrawork-state.json, autopilot-state.json, etc.) to surface orchestration modes and activity.
  • Presets and configuration via hud-config.json allow tailoring the display for focused monitoring or full detail in development environments.
  • Use cases include quick health checks, workflow visibility during development, and debugging multi-layer OMX orchestration.

Quick Start

Configure both layers with omx setup and start using omx hud to view real-time state from .omx/state files.

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 during local development?▼

The OMX HUD displays real-time orchestration state by reading JSON files under .omx/state/ (ralph-state.json, ultrawork-state.json, autopilot-state.json) to surface modes and activity. It also configures a Codex status line for quick context.

What is the best way to view system status without building heavy dashboards?▼

A two-layer HUD provides system status without heavy dashboards by combining a built-in Codex status line for model, git branch, and context usage with a dedicated CLI that reads .omx/state files for detailed orchestration visibility.

How do I set up and configure the OMX HUD for focused monitoring?▼

Set up the HUD by running omx setup to configure the Codex status line and .omx/hud-config.json. Tailor presets in the config file for focused monitoring or full detail in development environments.

Does the OMX HUD require specific state files to function properly?▼

Yes, the OMX HUD validates by verifying the presence of state files under .omx/state/, such as ralph-state.json, ultrawork-state.json, and autopilot-state.json. These files are required to surface orchestration modes and activity.

Can I use the HUD for quick health checks of multi-layer OMX workflows?▼

You can use the HUD for quick health checks of multi-layer OMX workflows. It surfaces orchestration states from .omx/state files, enabling faster triage and better situational awareness for local development and operations teams.