skills.rest
OliverOuyang
OliverOuyangCOMMUNITY
Explore all skills by this author →
GitHub

hud

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

1|Updated Apr 1, 2026
Search Tags:#claude#configuration#setup#statusline#hud#omc#agent-display
One-click install
npx skills add https://github.com/OliverOuyang/shuhe-work-skills --skill hud-oliverouyang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: hud
Source: https://github.com/OliverOuyang/shuhe-work-skills/tree/main/skills/hud
Command: npx skills add https://github.com/OliverOuyang/shuhe-work-skills --skill hud-oliverouyang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes manual HUD installation and fragile statusline configuration by automating creation of the HUD wrapper, validating plugin installations, and updating Claude Code settings to provide a consistent, portable status display.

Core Features & Use Cases

  • Automated detection and installation of the HUD wrapper script with development, plugin-cache, and npm fallbacks.
  • Preset display modes (minimal, focused, full) and configurable elements for context, agents, background tasks, and todos.
  • Platform-aware settings.json updates that respect CLAUDE_CONFIG_DIR and ensure forward-slash path compatibility across Unix and Windows.
  • Use Case: Quickly provision a consistent statusline for team members or restore HUD functionality after plugin upgrades.

Quick Start

Run /oh-my-claudecode:hud setup to install the HUD script, configure the statusLine in your Claude settings, and restart Claude Code.

Frequently Asked Questions about hud

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

FAQPage Schema
How do I configure a statusline for Claude Code automatically?▼

To configure a Claude Code statusline automatically, run the HUD setup command to install the wrapper script, update settings.json with a command-type statusLine, and apply platform-aware path formatting for consistent display.

How do I repair a broken HUD statusline after a plugin upgrade?▼

Repair a broken HUD statusline by running the setup command to verify plugin cache or npm packages, restore the wrapper script fallbacks, and reapply the command-type statusLine configuration in settings.json.

Can I use custom HUD presets to manage agent and context display elements?▼

Yes, you can use minimal, focused, or full preset display modes to manage configurable statusline elements including context, agents, background tasks, and todos for Claude Code.

Does the HUD setup script support Windows path compatibility?▼

Yes, the HUD setup script updates settings.json with forward-slash path compatibility and respects the CLAUDE_CONFIG_DIR environment variable to ensure portable statusline behavior across Unix and Windows platforms.

What's the best way to migrate legacy statusLine strings to the current HUD format?▼

Migrate legacy statusLine strings by running the automated HUD setup, which standardizes statusline behavior, creates a wrapper script, and updates settings.json to replace outdated configurations.

Why does my HUD wrapper script fail to load when the plugin cache is missing?▼

The HUD wrapper script fails without a plugin cache because it relies on validated installation paths; the setup command resolves this by checking npm fallbacks and providing clear error messages for missing dependencies.

Related Skills

Explore More Software Engineering Skills→
hg-pyunhg-pyun
2

install-statusline

Automate installation of the Claude Code status line and merge its configuration into settings.json.

Community
Basic
tiankong0101-bytetiankong0101-byte

hud

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

Community
Advanced
INNERJOINTINNERJOINT

hud

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

Community
Intermediate
sehoon787sehoon787
16

hud

Configure and automate the HUD statusline display in Claude Code.

Community
Intermediate