Configures the Oh My Claude Code heads-up display in your statusline. You get three presets: minimal shows just the essentials, focused (default) adds context percentage and agent counts, and full expands running agents into a multi-line tree view with durations and what each is doing. Colors shift from green to yellow to red as context fills up or Ralph iteration counts climb. The setup is a bit involved because it has to wire a Node wrapper script into settings.json and handle both Unix and Windows path quirks, but once it's running you get live visibility into Ralph loops, PRD stories, active skills, background tasks, and context pressure without opening another pane.

skills.sh installs
1.2K
GitHub stars
40.7K
last updated
Aug 21, 2026

Install

$ npx -y skills add yeachan-heo/oh-my-claudecode --skill hud --agent claude-code

Installs into .claude/skills of the current project.

Files

HUD Skill

Configure the OMC HUD (Heads-Up Display) for the statusline.

Note: All ~/.claude/... paths in this guide respect CLAUDE_CONFIG_DIR when that environment variable is set.

Quick Commands

CommandDescription
/oh-my-claudecode:hudShow current HUD status (auto-setup if needed)
/oh-my-claudecode:hud setupInstall/repair HUD statusline
/oh-my-claudecode:hud minimalSwitch to minimal display
/oh-my-claudecode:hud focusedSwitch to focused display (default)
/oh-my-claudecode:hud fullSwitch to full display
/oh-my-claudecode:hud statusShow detailed HUD status

Auto-Setup

When you run /oh-my-claudecode:hud or /oh-my-claudecode:hud setup, the system will automatically:

  1. Check if ~/.claude/hud/omc-hud.mjs exists
  2. Check if statusLine is configured in ~/.claude/settings.json
  3. If missing, create the HUD wrapper script and configure settings
  4. Report status and prompt to restart Claude Code if changes were made

Sponsors

Details

Repository
github.com/yeachan-heo/oh-my-claudecode
Category
Frontend Development
First seen
May 16, 2026

More from yeachan-heo/oh-my-claudecode

All 37
1wshuyi avatartranslate-pdfwshuyi/translate-pdf-skillTranslate PDF documents to any language while preserving original structure, layout, and styling (colors, backgrounds, positions). Use when user wants to: (1) t1.2Kskills.sh installs
2zsyggg avatarpaper-analyzerzsyggg/paper-craft-skills将学术论文转化为深度HTML长文。6轮强制工作流、代码仓库搜索、公式渲染、Mermaid图表。 3种写作风格,输出可直接分享的精美HTML页面。1.2Kskills.sh installs
3index-how avatarvocabularyindex-how/vocabularyThe precise design and UI vocabulary used on index.how/to/articulate — covering typography, color, iconography, layout, interaction, motion, accessibility, info1.2Kskills.sh installs
4mcollina avatarlinting-neostandard-eslint9mcollina/skillsConfigures ESLint v9 flat config and neostandard for JavaScript and TypeScript projects, including migrating from legacy `.eslintrc*` files or the `standard` pa1.2Kskills.sh installs
5vtex avatarvtex-io-session-appsvtex/skillsApply when building or debugging a VTEX IO session transform app (vtex.session integration). Covers namespace ownership, input-vs-output fields, transform order1.2Kskills.sh installs
6mindrally avatarnextauth-authenticationmindrally/skillsGuidelines for implementing NextAuth.js (Auth.js v5) authentication in Next.js applications with session management and security best practices1.2Kskills.sh installs