hud

Read local .omx/state/*.json files and expose OMX HUD state via the omx hud CLI.

2|1|Updated Oct 8, 2009
One-click install
npx skills add https://github.com/riethmayer/dotfiles --skill hud-riethmayer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hud
Source: https://github.com/riethmayer/dotfiles/tree/main/stow/agents/.agents/skills/hud
Command: npx skills add https://github.com/riethmayer/dotfiles --skill hud-riethmayer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

OMX HUD provides a two-layer status view to monitor OMX runtime state without manual tracking, combining a Codex status line and a CLI HUD.

Core Features & Use Cases

  • Layer 1: Codex built-in status line showing model, git branch, and context usage; Layer 2: omx hud command that reads .omx/state/*.json files to surface orchestration state like ralph, ultrawork, autopilot, team, and pipeline.
  • Use cases include real-time monitoring during runs, quick health checks of OMX workflows, and debugging state transitions.

Quick Start

Run omx setup to configure both HUD layers and load the default focused preset.

Frequently Asked Questions about hud

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

FAQPage Schema
How do I monitor OMX workflow status in real time?

The omx hud CLI reads local .omx/state/*.json files to surface orchestration state like ralph, ultrawork, autopilot, team, and pipeline during active runs. It provides real-time status visibility without manual tracking.

How do I configure Codex status line for OMX context awareness?

Configure the Codex status line for OMX context awareness by running omx setup, which writes to .omx/hud-config.json and updates the status_line in ~/.codex/config.toml to display model, git branch, and context usage.

What is the OMX HUD two-layer status view used for?

The OMX HUD two-layer status view combines a Codex built-in status line with a CLI HUD command to provide real-time monitoring, quick health checks of OMX workflows, and debugging of state transitions without manual tracking.

Does OMX HUD require manual config file setup before use?

OMX HUD does not require manual config file setup before use. Running the omx setup command automatically configures both HUD layers by writing to .omx/hud-config.json and updating ~/.codex/config.toml with the default focused preset.

Can I debug OMX state transitions using the hud command?

You can debug OMX state transitions using the hud command because it reads .omx/state/*.json files to expose orchestration states like ralph, ultrawork, autopilot, team, and pipeline, allowing quick health checks during runs.