hud_skill

Overview

This skill configures the OMC HUD (Heads-Up Display) used by Claude Code to show a compact statusline and multi-line agent details. It installs or repairs the HUD wrapper script, updates Claude Code settings to run the HUD command, and provides display presets and configuration options for layout and thresholds. Use it to switch between minimal, focused, and full HUD views and to customize which elements appear in the statusline.

How this skill works

The skill checks for a local HUD wrapper script (~/.claude/hud/omc-hud.mjs) and a configured statusLine entry in Claude Code settings. If missing or when run with setup, it creates the HUD script, makes it executable, and updates settings.json to point to the command that runs the HUD. The HUD loads a plugin cache or development build and renders presets (minimal, focused, full) plus multi-line agent displays and color-coded thresholds.

When to use it

• When Claude Code shows no statusline or the HUD is missing
• To switch HUD presets quickly (minimal, focused, full)
• After installing or updating the oh-my-claudecode plugin
• When you want to add or remove HUD elements (context, agents, todos)
• Before running multi-agent sessions to monitor agent activity

Best practices

• Run the built-in setup command to auto-create the wrapper and update settings
• Use the resolved absolute path for the statusLine command (no ~ in JSON)
• Restart Claude Code after making changes to settings.json or the HUD script
• Keep the plugin cache updated so the wrapper can import the latest build
• Edit ~/.claude/.omc/hud-config.json for persistent, granular customization

Example use cases

• Quickly switch to minimal HUD during demos to reduce visual noise
• Use focused preset as the default for active development sessions
• Enable full preset to inspect running agents with multi-line detail
• Adjust context warning thresholds when working with heavy prompt contexts
• Automate HUD installation during environment setup on new machines