hud

Configure an OMC HUD statusline with selectable presets for Claude Code sessions.

1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/Leap0920/Clean-Portfolio --skill hud-leap0920
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hud
Source: https://github.com/Leap0920/Clean-Portfolio/tree/main/%25USERPROFILE%25/.openclaude/plugins/cache/omc/oh-my-claudecode/4.14.0/skills/hud
Command: npx skills add https://github.com/Leap0920/Clean-Portfolio --skill hud-leap0920

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of not having enough real-time visibility into what Claude Code and OMC are doing while you work, so you can’t quickly spot context usage, agent progress, and task completion.

Core Features & Use Cases

  • HUD statusline presets: Switch between minimal, focused (default), and full displays to match how much information you want on-screen.
  • Operational visibility for active sessions: Shows live indicators such as repo/branch, Ralph loop progress, PRD story, context usage, agent counts, background tasks, and todos.
  • Troubleshooting and configuration: Guides you through installing/repairing the HUD wrapper and wiring it into Claude Code’s settings via the statusLine command.
  • Use case: When running a multi-agent coding session, the HUD helps you monitor progress and detect warnings (e.g., high context usage) without switching contexts to logs.

Quick Start

Run /oh-my-claudecode:hud setup to install the HUD wrapper and configure the status line in your settings.

Frequently Asked Questions about hud

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

FAQPage Schema
How do I monitor Claude Code session health and progress in real time?

To monitor Claude Code session health in real time, you can configure a HUD statusline that displays live indicators like context usage, agent counts, and task queues directly in your interactive coding environment.

How do I configure a statusline in settings.json for multi-agent workflows?

Configuring a statusline for multi-agent workflows involves updating settings.json safely within your configured CLAUDE_CONFIG_DIR to point to a locally generated statusline wrapper, making agent execution state and branch context remain visible.

Can I switch between different statusline display presets in my CLI configuration?

You can switch between selectable statusline display presets including setup, minimal, focused, and full configurations to match how much operational visibility information you want on-screen during active sessions.

What is the best way to track context usage and background tasks without switching to logs?

Tracking context usage and background tasks without switching to logs is best achieved by installing a HUD wrapper that shows live operational indicators like Ralph loop progress and todos directly in your statusline.

Why is my HUD statusline not showing up during interactive coding sessions?

If your HUD statusline is not showing up, the statusLine command in settings.json may be missing or pointing to an incorrect wrapper path, requiring you to run the setup command to repair the installation.

Do I need a specific CLAUDE_CONFIG_DIR to install the HUD wrapper correctly?

You need a configured CLAUDE_CONFIG_DIR because the HUD installation updates settings.json safely within that specific directory to ensure the statusline wrapper is correctly wired into your environment.