hud

Configure Claude Code HUD wrapper and statusline settings.

Updated Apr 29, 2026

Search Tags:#configuration #Claude Code #statusline #settings.json #hud #runtime monitoring #preset management

Ready to run

npx skills add https://github.com/nichobbs/lyric-lang --skill hud-nichobbs

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: hud
Source: https://github.com/nichobbs/lyric-lang/tree/main/.claude/skills/hud
Command: npx skills add https://github.com/nichobbs/lyric-lang --skill hud-nichobbs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The hud Skill configures an always-on Heads-Up Display so you can quickly understand Claude Code activity and project context at a glance, without manually checking logs or UI details.

Core Features & Use Cases

Auto-setup for the statusline HUD: installs or repairs the ~/.claude/hud/omc-hud.mjs wrapper and ensures ~/.claude/settings.json is configured for statusLine.
Preset-based layout control: switch between minimal, focused (default), full, and view status to troubleshoot the current HUD configuration.
Rich status elements and thresholds: display repo/branch, Ralph iteration progress, story ID, context usage, agent counts, background task slots, and todo completion with color-coded severity.
Multi-line agent reporting: show hierarchical agent details with durations and short descriptions while agents run.

Quick Start

Run the hud Skill to initialize the statusline HUD and apply 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 configure a Claude Code statusline to monitor runtime activity?▼

Configuring a Claude Code statusline involves setting up an omc-hud.mjs wrapper and updating settings.json to display runtime state and project context. The HUD skill automates this setup by copying the canonical wrapper template and safely applying the default focused preset.

How do I switch between different HUD display layouts in Claude Code?▼

Switching HUD display layouts in Claude Code is done by applying preset configurations. You can switch between minimal, focused, and full presets, or use the status preset to troubleshoot and view the current HUD configuration.

What runtime information can I display in a Claude Code statusline?▼

A Claude Code statusline can display repo and branch details, context usage, agent counts, background task slots, and todo completion with color-coded severity. It also supports multi-line hierarchical agent reporting with durations and short descriptions.

Why is my Claude Code statusline not showing up after updating settings.json?▼

A missing Claude Code statusline often indicates a misconfigured settings.json or a missing omc-hud.mjs wrapper. You need to ensure the canonical wrapper is copied to the correct location and restart Claude Code for the settings changes to take effect.

Can I migrate a legacy statusLine format to a new HUD configuration?▼

Migrating a legacy statusLine format to a new HUD configuration is supported by detecting existing settings and updating them safely. The process involves replacing old statusLine entries with the canonical omc-hud.mjs wrapper path within the allowed scope.

Do I need to restart Claude Code after changing HUD presets?▼

Restarting Claude Code is required after changing HUD presets or updating settings.json. The statusline wrapper relies on the initial session load to detect runtime state and project context, so changes will not appear in an active session without a restart.