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.