hud

Configure Claude Code HUD display options and automate wrapper setup.

38.5k|3.5k|Updated Jan 9, 2026

Search Tags:#automation #configuration #setup #statusline #claude-code #script #hud

Ready to run

npx skills add https://github.com/Yeachan-Heo/oh-my-claudecode --skill hud-yeachan-heo

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: hud
Source: https://github.com/Yeachan-Heo/oh-my-claudecode/tree/main/skills/hud
Command: npx skills add https://github.com/Yeachan-Heo/oh-my-claudecode --skill hud-yeachan-heo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Configures the HUD display options for Claude Code and automates the initial setup of the HUD wrapper, enabling a ready-to-use status line.

Core Features & Use Cases

Auto-create and configure the HUD script at ~/.claude/hud/omc-hud.mjs so Claude can render the status line automatically.
Integrates with the Claude Code statusLine setting to display live HUD metrics and support quick preset switching (minimal, focused, full).
Provides a streamlined Quick Start workflow to install, verify, and customize the HUD for different workflows.

Quick Start

Run the following commands to initialize and customize the HUD: /oh-my-claudecode:hud /oh-my-claudecode:hud setup /oh-my-claudecode:hud minimal /oh-my-claudecode:hud focused /oh-my-claudecode:hud full

Frequently Asked Questions about hud

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

FAQPage Schema

How do I configure the status line in Claude Code?▼

To configure the status line in Claude Code, this Skill automates the creation of a HUD script at ~/.claude/hud/omc-hud.mjs and links it via the statusLine entry in ~/.claude/settings.json. It enables live HUD metrics and quick preset switching.

What are the available HUD presets for Claude Code?▼

The available HUD presets for Claude Code are minimal, focused, and full. You can switch between them using the commands /oh-my-claudecode:hud minimal, focused, or full to tailor the status line display to your workflow.

How do I automate HUD setup for a local Claude Code environment?▼

You can automate HUD setup for a local Claude Code environment by running the /oh-my-claudecode:hud setup command. This workflow verifies dependencies, creates the required wrapper script, and applies your chosen status line configuration automatically.

Do I need a specific script location to enable the Claude Code HUD?▼

Yes, enabling the Claude Code HUD requires a script located at ~/.claude/hud/omc-hud.mjs. The setup process also configures a statusLine entry in ~/.claude/settings.json, with optional fallbacks for plugin-cache or development-paths.

Can I customize live metrics displayed in my Claude Code status line?▼

Yes, you can customize live metrics displayed in your Claude Code status line by applying presets like minimal, focused, or full. The Skill configures the HUD display options to show tailored status metrics based on your selected preset.