hud

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

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/dropsyoon/oh-my-claudecode --skill hud-dropsyoon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hud
Source: https://github.com/dropsyoon/oh-my-claudecode/tree/main/skills/hud
Command: npx skills add https://github.com/dropsyoon/oh-my-claudecode --skill hud-dropsyoon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

You can’t easily monitor Claude Code session state at a glance, and manual HUD setup is error-prone and inconsistent across machines.

Core Features & Use Cases

  • Auto-configures the HUD statusline by installing or repairing the required wrapper script and wiring it into settings.json.
  • Supports display presets (minimal, focused, full) so you can match HUD verbosity to your workflow.
  • Shows live operational context like repo/branch, ralph loop progress, context usage, running agents, background tasks, and todos during active sessions.

Quick Start

Run the hud skill to install and configure the HUD automatically for your current Claude Code session.

Frequently Asked Questions about hud

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

FAQPage Schema
How do I configure the Claude Code HUD statusline?

To configure the Claude Code HUD statusline, you need a wrapper script installed in your Claude config directory and the `statusLine` object properly set in `settings.json`. This Skill automates that setup and repairs existing configurations in one command.

What does the Claude Code HUD display during active CLI workflows?

The HUD displays live operational context during CLI workflows, including your repository and branch, ralph loop progress, context usage, running agents, background tasks, and active todos for multi-agent orchestration sessions.

Can I switch HUD display presets for different Claude Code workflows?

Yes, you can switch between minimal, focused, and full display presets to match HUD verbosity to your workflow. This allows you to toggle the amount of operational context shown during active multi-agent sessions.

Why is my Claude Code statusline not working after manual setup?

Manual HUD setup is error-prone because the `statusLine` entry in `settings.json` requires a specific object format and a correctly placed wrapper script. Running this Skill repairs the wrapper and fixes the configuration automatically.

Do I need to manually edit settings.json to enable the OMC HUD?

No, you do not need to manually edit `settings.json` to enable the OMC HUD. This Skill automatically installs the required wrapper script under your Claude config directory and wires the `statusLine` object into your settings.