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-codeInstalls 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
| Command | Description |
|---|---|
/oh-my-claudecode:hud | Show current HUD status (auto-setup if needed) |
/oh-my-claudecode:hud setup | Install/repair HUD statusline |
/oh-my-claudecode:hud minimal | Switch to minimal display |
/oh-my-claudecode:hud focused | Switch to focused display (default) |
/oh-my-claudecode:hud full | Switch to full display |
/oh-my-claudecode:hud status | Show detailed HUD status |
Auto-Setup
When you run /oh-my-claudecode:hud or /oh-my-claudecode:hud setup, the system will automatically:
- Check if
~/.claude/hud/omc-hud.mjsexists - Check if
statusLineis configured in~/.claude/settings.json - If missing, create the HUD wrapper script and configure settings
- 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
