hud

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

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/INNERJOINT/HarnessSkills --skill hud-innerjoint
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: hud
Source: https://github.com/INNERJOINT/HarnessSkills/tree/main/skills/hud
Command: npx skills add https://github.com/INNERJOINT/HarnessSkills --skill hud-innerjoint

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The HUD skill simplifies configuring and maintaining a compact, real-time statusline for Claude Code so users can monitor repository, agent, context, and background task state without manual file juggling.

Core Features & Use Cases

  • Auto-detection and setup: Checks for ~/.claude/hud/omc-hud.mjs and auto-creates the wrapper script when missing.
  • StatusLine configuration: Guides updating ~/.claude/settings.json to a portable node command for consistent status output across platforms.
  • Plugin resolution and fallbacks: Resolves development paths, plugin cache versions, or npm package installs and reports actionable build or install steps.
  • Use case: Developers installing or restoring OMC HUD on a new machine can run the setup flow to ensure the HUD script exists, the statusLine is configured, and the display preset is active.

Quick Start

Run /oh-my-claudecode:hud setup to install the HUD wrapper, update your settings, and then restart Claude Code for the changes to take effect.

Frequently Asked Questions about hud

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

FAQPage Schema
How do I configure a real-time statusline for Claude Code?

To configure a real-time statusline for Claude Code, run the setup command to auto-create the wrapper script at ~/.claude/hud/omc-hud.mjs and update ~/.claude/settings.json with a portable node command for consistent status output.

How do I monitor multi-agent session status in Claude Code?

You can monitor multi-agent session status in Claude Code by applying a HUD preset that presents compact, real-time repository, agent, context, and background task state directly within your configured statusline.

Does the HUD setup work with custom CLAUDE_CONFIG_DIR deployments?

Yes, the HUD setup works with custom CLAUDE_CONFIG_DIR deployments, local Claude Code installations, and workflows that require persistent statusLine commands across different environments.

What is the best way to fix a missing HUD script after moving to a new machine?

The best way to fix a missing HUD script on a new machine is to run the setup flow, which validates or creates the ~/.claude/hud/omc-hud.mjs wrapper, resolves plugin cache and dev paths, and provides build and restart instructions.

Why is my Claude Code statusLine not displaying after configuration?

Your Claude Code statusLine may not display if the settings were updated but the application was not restarted. You must restart Claude Code for the new node command and HUD display preset changes to take effect.

Do I need Node installed to use the HUD statusline?

Yes, you need Node installed because the statusLine configuration in ~/.claude/settings.json is set to a portable node command to execute the wrapper script and generate the status output.