skills.rest
nichobbs
nichobbsCOMMUNITY
Explore all skills by this author →
GitHub

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
One-click install
npx skills add https://github.com/nichobbs/lyric-lang --skill hud-nichobbs
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Product & Management Skills→
INNERJOINTINNERJOINT

hud

Configure Claude Code HUD statusLine with a node command and wrapper script.

Community
Intermediate
OliverOuyangOliverOuyang
1

hud

Configure HUD display options and update Claude Code settings.json with a command-type statusLine.

Community
Advanced
tiankong0101-bytetiankong0101-byte

hud

Configure Claude Code HUD display settings and statusline integration for OMC installations.

Community
Advanced
dropsyoondropsyoon

hud

Configures Claude Code OMC HUD statusline and manages preset modes via settings.json.

Community
Intermediate