skills.rest
ogiboy
ogiboyCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

hud

Displays and configures the OMX two-layer statusline HUD for Codex CLI.

Updated Feb 1, 2024
Search Tags:#monitoring#configuration#terminal#statusline#codex cli#hud#omx
One-click install
npx skills add https://github.com/ogiboy/portfolio-app --skill hud-ogiboy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hud
Source: https://github.com/ogiboy/portfolio-app/tree/main/.codex/skills/hud
Command: npx skills add https://github.com/ogiboy/portfolio-app --skill hud-ogiboy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Developers running OMX orchestration workflows in Codex CLI lack visibility into active modes like ralph loops, autopilot phases, and team workers. This Skill shows how to display and configure a two-layer HUD that surfaces orchestration state in real time. ## Core Features & Use Cases - Two-layer statusline: Combines the Codex built-in TUI statusline (model, git branch, context usage) with the omx hud CLI for OMX-specific state. - Presets and live monitoring: Choose minimal, focused, or full presets, watch state update every second, or emit JSON for scripting. - Use Case: While running a ralph loop with a 3-worker team, run omx hud --watch to see iteration progress, worker count, and turn counts update live in your terminal. ## Quick Start Ask the assistant to show the current OMX HUD state and configure the focused preset for the statusline.

Frequently Asked Questions about hud

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

FAQPage Schema
How do I show the OMX HUD statusline in Codex CLI?▼

Run `omx hud` to display current orchestration state including active modes, turns, and last activity. Use `omx hud --watch` for a live-updating display that polls every second, or `omx hud --json` for raw state output suitable for scripting.

How do I configure the Codex built-in statusline?▼

Run `omx setup`, which adds a `[tui] status_line` section to `~/.codex/config.toml` with items like model-with-reasoning, git-branch, and context-remaining. Restart Codex CLI once for the statusline changes to appear.

What HUD presets are available and how do they differ?▼

Three presets exist: minimal shows only ralph iteration and turns, focused (the default) adds active modes, team workers, and last activity, and full adds autopilot phase, pipeline stage, and total turns. Set the preset with `omx hud --preset=focused` or in `.omx/hud-config.json`.

Why is the TUI statusline not showing after setup?▼

The statusline requires Codex CLI v0.101.0 or later. Verify your version, run `omx setup` to write the `[tui]` configuration section, then restart Codex CLI so the new configuration is loaded.

Why does omx hud show "No active modes"?▼

This message is expected when no OMX workflows are running. The HUD reads state files under `.omx/state/`, which are only populated when workflows like ralph, autopilot, ultrawork, team, or pipeline are active.

Related Skills

Explore More Software Engineering Skills→
hotaqhotaq

hud

Configure the OMX HUD status line for Codex CLI sessions using .omx state files and hud config.

Community
Intermediate
Yeachan-HeoYeachan-Heo
32.9k

hud

Displays and configures the OMX two-layer statusline showing orchestration state and presets.

Community
Basic
OrinksOrinks
24

hud

Read .omx/state files and configure the OMX HUD status line.

Community
Intermediate
peeka-projectpeeka-project
6

postmortem

Analyze Git fix commits and generate structured postmortem reports.

Official
Advanced