hud

Read OMX HUD state and configuration from .omx files.

Updated Jul 3, 2025
One-click install
npx skills add https://github.com/andrew-t-james/dotfiles --skill hud-andrew-t-james
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hud
Source: https://github.com/andrew-t-james/dotfiles/tree/main/dot_codex/skills/hud
Command: npx skills add https://github.com/andrew-t-james/dotfiles --skill hud-andrew-t-james

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Show or configure the OMX HUD to provide at-a-glance visibility into current modes, turns, and context usage, reducing manual checks during Codex workflows.

Core Features & Use Cases

  • Layered HUD: real-time TUI status line plus CLI state reporting for OMX orchestration.
  • Presets & Config: supports default and custom presets via .omx/hud-config.json.
  • Use Case: quickly verify active mode, turns, and team state during a Codex workflow.

Quick Start

Run omx hud to display the current HUD state and apply the default 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 HUD status and configuration in real-time?

You can monitor OMX HUD status by running the `omx hud` command, which reads `.omx/state` files and `.omx/hud-config.json` to display current modes, turns, and context usage at a glance during Codex workflows.

How do I configure OMX HUD presets for my workflow?

To configure OMX HUD presets, define your custom presets in the `.omx/hud-config.json` file. The configuration supports default and custom presets, allowing you to quickly apply specific HUD states when running `omx hud` commands.

Can I get OMX state files output as JSON for programmatic access?

Yes, you can get OMX state files output as JSON by appending the `--json` option to the `omx hud` command. This formats the state reporting from `.omx/state` into structured JSON for programmatic consumption.

What is the OMX HUD used for in Codex orchestration?

The OMX HUD provides at-a-glance visibility into current modes, turns, and team state during Codex workflows. It reduces manual checks by offering a real-time TUI status line and CLI state reporting for OMX orchestration.

Do I need specific dependencies to run the OMX HUD monitoring tool?

No specific dependencies are required to run the OMX HUD monitoring tool. It operates independently by reading the existing `.omx/state` files and `.omx/hud-config.json` configuration within your project environment.