skills.rest
chrisxue90
chrisxue90COMMUNITY
Explore all skills by this author →
GitHub

hud

Display OMQ runtime and orchestration state from .omq/ files via CLI.

2|2|Updated Apr 3, 2026
Search Tags:#workflow#ui#monitoring#cli#state#hud#omq
One-click install
npx skills add https://github.com/chrisxue90/oh-my-qwencode --skill hud-chrisxue90
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hud
Source: https://github.com/chrisxue90/oh-my-qwencode/tree/main/skills/hud
Command: npx skills add https://github.com/chrisxue90/oh-my-qwencode --skill hud-chrisxue90

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

HUD visibility and real-time status awareness are essential for managing OMQ sessions. This skill provides a centralized view of runtime state and configuration to help operators stay informed without extra tooling.

Core Features & Use Cases

  • Layer 1: Qwen Code built-in status_line shows model, git branch, and context usage.
  • Layer 2: The omq hud CLI reads .omq/state files to display orchestration state (ralph, ultrawork, autopilot, team, pipeline, ecomode, and hud state).
  • Use Case: Quickly verify HUD state during active workflows and tailor presets to fit current tasks.

Quick Start

Run omq hud to display the current HUD state and switch presets as needed.

Frequently Asked Questions about hud

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

FAQPage Schema
How do I view OMQ runtime state and orchestration activity from the CLI?▼

To view OMQ runtime state, run the `omq hud` CLI command, which reads `.omq/state` files to display active orchestration modes, turns, and configuration presets for your current session.

What is the OMQ HUD and what session details does it display?▼

The OMQ HUD is a real-time status interface showing runtime state across two layers: Qwen Code built-in status lines for model and context usage, and CLI-read state files for orchestration modes like ralph, ultrawork, and autopilot.

How do I switch HUD presets to match my current workflow tasks?▼

You can switch HUD presets by running `omq hud` and selecting the desired configuration, allowing you to quickly tailor the display of orchestration state, ecomode, and pipeline activity to fit your active workflow.

Can I monitor remote OMQ sessions or is the HUD limited to local runs?▼

You can monitor both local and remote OMQ runs. The HUD reads state files from the `.omq/` directory to ensure deterministic, observable behavior and quick verification of orchestration activity across different execution environments.

Do I need to run omq setup before displaying the HUD state?▼

Running `omq setup` is required to configure the session and generate the necessary `.omq/state` files. The `omq hud` CLI relies on these state files to correctly display orchestration modes, turns, and layer configuration.

Why is my OMQ HUD not showing orchestration state like ralph or pipeline modes?▼

If the HUD is not showing orchestration state, the `.omq/state` files may be missing or not updated. Ensure you run `omq setup` to properly initialize the session and generate the state data required by the `omq hud` CLI.

Related Skills

Explore More Software Engineering Skills→
chrisxue90chrisxue90
2

ralph-init

Generate a canonical PRD and initialize a Ralph progress ledger.

Community
Advanced
hotaqhotaq

hud

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

Community
Intermediate
gtpgg1013gtpgg1013

hud

Display OMX orchestration status with a two-layer heads-up display.

Community
Intermediate
prthikprthik
1

hud

Display OMX HUD status and configuration from .omx/state files via CLI.

Community
Intermediate