Agent skill

OMC HUD Statusline Setup

by Yeachan-Heo in Yeachan-Heo/oh-my-claudecode

Installs and configures the oh-my-claudecode heads-up display in the Claude Code statusline, with minimal, focused and full layouts.

MITAuto-check passedAgent Workflows

Install OMC HUD Statusline Setup

skills CLI

$ npx skills add Yeachan-Heo/oh-my-claudecode --skill hud -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install Yeachan-Heo/oh-my-claudecode hud --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/Yeachan-Heo/oh-my-claudecode.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/hud .claude/skills/hud && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "hud" agent skill from https://github.com/Yeachan-Heo/oh-my-claudecode/tree/main/skills/hud into .claude/skills/hud/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hud", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/Yeachan-Heo/oh-my-claudecode/tree/main/skills/hud

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add Yeachan-Heo/oh-my-claudecode --skill hud -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install Yeachan-Heo/oh-my-claudecode hud --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Yeachan-Heo/oh-my-claudecode.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/hud .agents/skills/hud && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "hud" agent skill from https://github.com/Yeachan-Heo/oh-my-claudecode/tree/main/skills/hud into .agents/skills/hud/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hud", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Yeachan-Heo/oh-my-claudecode --skill hud -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install Yeachan-Heo/oh-my-claudecode hud --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Yeachan-Heo/oh-my-claudecode.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/hud .cursor/skills/hud && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "hud" agent skill from https://github.com/Yeachan-Heo/oh-my-claudecode/tree/main/skills/hud into .cursor/skills/hud/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hud", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/Yeachan-Heo/oh-my-claudecode.git --path skills/hud

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add Yeachan-Heo/oh-my-claudecode --skill hud -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install Yeachan-Heo/oh-my-claudecode hud --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Yeachan-Heo/oh-my-claudecode.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/hud .gemini/skills/hud && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "hud" agent skill from https://github.com/Yeachan-Heo/oh-my-claudecode/tree/main/skills/hud into .gemini/skills/hud/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hud", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install Yeachan-Heo/oh-my-claudecode hud

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add Yeachan-Heo/oh-my-claudecode --skill hud -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/Yeachan-Heo/oh-my-claudecode.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/hud .github/skills/hud && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "hud" agent skill from https://github.com/Yeachan-Heo/oh-my-claudecode/tree/main/skills/hud into .github/skills/hud/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hud", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Yeachan-Heo/oh-my-claudecode --skill hud -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install Yeachan-Heo/oh-my-claudecode hud --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Yeachan-Heo/oh-my-claudecode.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/hud .opencode/skills/hud && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "hud" agent skill from https://github.com/Yeachan-Heo/oh-my-claudecode/tree/main/skills/hud into .opencode/skills/hud/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "hud", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: hud
GitHub stars: 40k
Token cost: ~2.5k tokens
SKILL.md length: 780 words
Files: 1
Skills in repo: 47
Repo updated: Oct 8, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

Installs and configures the oh-my-claudecode heads-up display in the Claude Code statusline, with minimal, focused and full layouts.

Works in 4 steps: Check if ~/.claude/hud/omc-hud.mjs exists → Check if statusLine is configured in… → If missing, create the HUD wrapper… → …
Turning on the OMC statusline display for the first time
SKILL.md covers Quick Commands, Auto-Setup, Display Presets and Multi-Line Agent Display, plus 5 more sections
Calls node

What it does

The skill manages the OMC HUD through subcommands: plain `hud` shows the current status and sets itself up when needed, `setup` installs or repairs it, `minimal`, `focused` (the default) and `full` switch the layout, and `status` prints details. Auto-setup checks whether `~/.claude/hud/omc-hud.mjs` exists and whether a `statusLine` entry is present in `~/.claude/settings.json`, creates the wrapper script and settings if not, and asks you to restart Claude Code after a change.

The wrapper is always copied from the plugin's template file instead of being written inline, because that template is guarded by tests for drift. A short Node command checks whether setup is needed, another verifies the plugin is installed, and a later step makes the script executable on Unix. All `~/.claude` paths follow `CLAUDE_CONFIG_DIR` when it is set. The excerpt is truncated after the executable step.

When your agent uses it

Turning on the OMC statusline display for the first time
Repairing a HUD that stopped showing after an update
Switching between minimal, focused and full HUD layouts

Example prompts

“Set up the OMC HUD in my statusline.”
“Switch the HUD to the minimal layout.”
“Show the detailed HUD status and fix it if the wrapper script is missing.”

Requirements

The oh-my-claudecode plugin installed
Node.js to run the HUD script

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

Check if ~/.claude/hud/omc-hud.mjs exists
Check if statusLine is 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

What it can do on your machine

Read from SKILL.md and the folder at commit 454bae0. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
- node
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

OMC HUD Statusline Setup loads about 2.5k tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 780 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~17
When it runs · the whole SKILL.md, loaded when a task matches: ~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Yeachan-Heo/oh-my-claudecode at commit 454bae0, republished under its MIT licence (© Yeachan-Heo). 780 words, ~2,544 tokens.

Download SKILL.mdSave it as .claude/skills/hud/SKILL.md (or your agent's skills folder).

name: hud
description: Configure HUD display options (layout, presets, display elements)
argument-hint: [setup|minimal|focused|full|status]
role: config-writer
scope: ~/.claude/**
level: 2

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.mjs exists
Check if statusLine is 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

IMPORTANT: If the argument is setup OR if the HUD script doesn't exist at ~/.claude/hud/omc-hud.mjs, you MUST create the HUD files directly using the instructions below.

Setup Instructions (Run These Commands)

Step 1: Check if setup is needed:

bash

node -e "const p=require('path'),f=require('fs'),d=process.env.CLAUDE_CONFIG_DIR||p.join(require('os').homedir(),'.claude');console.log(f.existsSync(p.join(d,'hud','omc-hud.mjs'))?'EXISTS':'MISSING')"

Step 2: Verify the plugin is installed:

bash

node -e "const p=require('path'),f=require('fs'),d=process.env.CLAUDE_CONFIG_DIR||p.join(require('os').homedir(),'.claude'),b=p.join(d,'plugins','cache','omc','oh-my-claudecode');try{const v=f.readdirSync(b).filter(x=>/^\d/.test(x)).sort((a,c)=>a.localeCompare(c,void 0,{numeric:true}));if(v.length===0){console.log('Plugin not installed - run: /plugin install oh-my-claudecode');process.exit()}const l=v[v.length-1],h=p.join(b,l,'dist','hud','index.js');console.log('Version:',l);console.log(f.existsSync(h)?'READY':'NOT_FOUND - try reinstalling: /plugin install oh-my-claudecode')}catch{console.log('Plugin not installed - run: /plugin install oh-my-claudecode')}"

Step 3: If omc-hud.mjs is MISSING or argument is setup, install the HUD wrapper and its dependency from the canonical template:

bash

HUD_DIR="${CLAUDE_CONFIG_DIR:-$HOME/.claude}/hud"
mkdir -p "$HUD_DIR/lib"
cp "${CLAUDE_PLUGIN_ROOT}/scripts/lib/hud-wrapper-template.txt" "$HUD_DIR/omc-hud.mjs"
cp "${CLAUDE_PLUGIN_ROOT}/scripts/lib/config-dir.mjs" "$HUD_DIR/lib/config-dir.mjs"

IMPORTANT: Always copy from the canonical template at scripts/lib/hud-wrapper-template.txt. Do NOT write the wrapper content inline — the template is the single source of truth and is guarded by drift tests (src/__tests__/hud-wrapper-template-sync.test.ts, src/__tests__/paths-consistency.test.ts).

Step 4: Make it executable (Unix only, skip on Windows):

bash

node -e "if(process.platform==='win32'){console.log('Skipped (Windows)')}else{require('fs').chmodSync(require('path').join(process.env.CLAUDE_CONFIG_DIR||require('path').join(require('os').homedir(),'.claude'),'hud','omc-hud.mjs'),0o755);console.log('Done')}"

Step 5: Update settings.json to use the HUD:

Read ${CLAUDE_CONFIG_DIR:-~/.claude}/settings.json, then update/add the statusLine field.

IMPORTANT: Do not use ~ in the command. On Unix, use $HOME to keep the path portable across machines. On Windows, use an absolute path because Windows does not expand ~ in shell commands.

If you are on Windows, first determine the correct path:

bash

node -e "const p=require('path').join(require('os').homedir(),'.claude','hud','omc-hud.mjs').split(require('path').sep).join('/');console.log(JSON.stringify(p))"

IMPORTANT: The command path MUST use forward slashes on all platforms. Claude Code executes statusLine commands via bash, which interprets backslashes as escape characters and breaks the path.

Then set the statusLine field. On Unix it should stay portable and look like:

json

{
  "statusLine": {
    "type": "command",
    "command": "node ${CLAUDE_CONFIG_DIR:-$HOME/.claude}/hud/omc-hud.mjs"
  }
}

On Windows the path uses forward slashes (not backslashes):

json

{
  "statusLine": {
    "type": "command",
    "command": "node C:/Users/username/.claude/hud/omc-hud.mjs"
  }
}

Use the Edit tool to add/update this field while preserving other settings.

Step 6: Clean up old HUD scripts (if any):

bash

node -e "const p=require('path'),f=require('fs'),d=process.env.CLAUDE_CONFIG_DIR||p.join(require('os').homedir(),'.claude'),t=p.join(d,'hud','omc-hud.js');try{if(f.existsSync(t)){f.unlinkSync(t);console.log('Removed legacy omc-hud.js')}else{console.log('No legacy script found')}}catch{}"

Step 7: Tell the user to restart Claude Code for changes to take effect.

Display Presets

Minimal

Shows only the essentials:

[OMC] ralph | todos:2/5

Focused (Default)

Shows all relevant elements:

[OMC] branch:main | ralph:3/10 | US-002 | skill:planner | ctx:67% | agents:2 | bg:3/5 | todos:2/5

Full

Shows everything including multi-line agent details:

[OMC] repo:oh-my-claudecode branch:main | ralph:3/10 | US-002 (2/5) | ctx:[████░░]67% | agents:3 | bg:3/5 | todos:2/5
├─ O architect    2m   analyzing architecture patterns...
├─ e explore     45s   searching for test files
└─ s executor     1m   implementing validation logic

Multi-Line Agent Display

When agents are running, the HUD shows detailed information on separate lines:

Tree characters (├─, └─) show visual hierarchy
Agent code (O, e, s) indicates agent type with model tier color
Duration shows how long each agent has been running
Description shows what each agent is doing (up to 45 chars)

Display Elements

Element	Description
`[OMC]`	Mode identifier
`repo:name`	Git repository name (cyan)
`branch:name`	Git branch name (cyan)
`ralph:3/10`	Ralph loop iteration/max
`US-002`	Current PRD story ID
`skill:name`	Last activated skill (cyan)
`ctx:67%`	Context window usage
`agents:2`	Running subagent count
`bg:3/5`	Background task slots
`todos:2/5`	Todo completion

Show full SKILL.md (294 more words)Show less

Color Coding

Green: Normal/healthy
Yellow: Warning (context >70%, ralph >7)
Red: Critical (context >85%, ralph at max)

Configuration Location

HUD config is stored in ~/.claude/settings.json under the omcHud key (or your custom config directory if CLAUDE_CONFIG_DIR is set).

Legacy config location (deprecated): ~/.claude/.omc/hud-config.json

Manual Configuration

You can manually edit the config file. Each option can be set individually - any unset values will use defaults.

json

{
  "preset": "focused",
  "elements": {
    "omcLabel": true,
    "updateNotification": true,
    "ralph": true,
    "autopilot": true,
    "prdStory": true,
    "activeSkills": true,
    "lastSkill": true,
    "contextBar": true,
    "agents": true,
    "agentsFormat": "multiline",
    "backgroundTasks": true,
    "todos": true,
    "thinking": true,
    "thinkingFormat": "text",
    "permissionStatus": false,
    "apiKeySource": false,
    "profile": true,
    "promptTime": true,
    "sessionHealth": true,
    "useBars": true,
    "showCallCounts": true,
    "callCountsFormat": "auto",
    "safeMode": true,
    "maxOutputLines": 4
  },
  "thresholds": {
    "contextWarning": 70,
    "contextCompactSuggestion": 80,
    "contextCritical": 85,
    "ralphWarning": 7
  },
  "staleTaskThresholdMinutes": 30,
  "contextLimitWarning": {
    "threshold": 80,
    "autoCompact": false
  }
}

callCountsFormat

Controls the call-count badge icon style:

"auto" (default): emoji on macOS/Linux, ASCII on Windows/WSL
"emoji": force 🔧 🤖 ⚡
"ascii": force T: A: S:

safeMode

When safeMode is true (default), the HUD strips ANSI codes and uses ASCII-only output to prevent terminal rendering corruption during concurrent updates. This is especially important on Windows and when using terminal multiplexers.

agentsFormat Options

count: agents:2
codes: agents:Oes (type-coded with model tier casing)
codes-duration: agents:O(2m)es (codes with duration)
detailed: agents:[architect(2m),explore,exec]
descriptions: O:analyzing code | e:searching (codes + what they're doing)
tasks: [analyzing code, searching...] (just descriptions)
multiline: Multi-line display with full agent details on separate lines

Troubleshooting

If the HUD is not showing:

Run /oh-my-claudecode:hud setup to auto-install and configure
Restart Claude Code after setup completes
If still not working, run /oh-my-claudecode:omc-doctor for full diagnostics

Legacy string format migration: Older OMC versions wrote statusLine as a plain string (e.g., "~/.claude/hud/omc-hud.mjs"). Modern Claude Code (v2.1+) requires an object format. Running the installer or /oh-my-claudecode:hud setup will auto-migrate legacy strings to the correct object format:

json

{
  "statusLine": {
    "type": "command",
    "command": "node ${CLAUDE_CONFIG_DIR:-$HOME/.claude}/hud/omc-hud.mjs"
  }
}

Node 24+ compatibility: The HUD wrapper script imports homedir from node:os (not node:path). If you encounter SyntaxError: The requested module 'path' does not provide an export named 'homedir', re-run the installer to regenerate omc-hud.mjs.

Manual verification:

HUD script: ~/.claude/hud/omc-hud.mjs
Settings: ~/.claude/settings.json should have statusLine configured as an object with type and command fields

The HUD updates automatically every ~300ms during active sessions.

Files

Just SKILL.md in skills/hud of Yeachan-Heo/oh-my-claudecode.

Open the folder on GitHubat commit 454bae0

Compare with similar skills

OMC HUD Statusline Setup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

OMC HUD Statusline Setup compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
OMC HUD Statusline Setup this skillYeachan-Heo/oh-my-claudecode	40k	—	~2.5k	Automated safety check: Pass	MIT	2 days ago
Hook Development for Claude Code Pluginsanthropics/claude-plugins-official	38k	10 repos	~4.1k	Automated safety check: Notes	Apache-2.0	yesterday
Claude Code Agent Developmentanthropics/claude-plugins-official	38k	7 repos	~2.8k	Automated safety check: Pass	Apache-2.0	yesterday
Claude Code Skill Developer Guidediet103/claude-code-infrastructure-showcase	10k	11 repos	~3.5k	Automated safety check: Pass	MIT	2 mo ago
Plugin Settings Patternanthropics/claude-plugins-official	38k	7 repos	~3k	Automated safety check: Pass	Apache-2.0	yesterday
MCP Integration for Pluginsanthropics/claude-plugins-official	38k	11 repos	~3.1k	Automated safety check: Pass	Apache-2.0	yesterday

Similar skills

Hook Development for Claude Code Plugins
anthropics/claude-plugins-official
Official
Explains how to write Claude Code plugin hooks, both prompt-based checks and bash commands, for events such as PreToolUse, Stop and SessionStart.
38k GitHub starsUsed in 10 repos~4.1k tokens
Agent WorkflowsAuto-check: notes
Claude Code Agent Development
anthropics/claude-plugins-official
Official
Explains how to write agents for Claude Code plugins: the markdown file with YAML frontmatter, trigger descriptions, model and color settings, and system prompt design.
38k GitHub starsUsed in 7 repos~2.8k tokens
Agent WorkflowsAuto-check passed
Claude Code Skill Developer Guide
diet103/claude-code-infrastructure-showcase
A guide to creating and managing Claude Code skills with auto-activation: skill-rules.json triggers, hooks, enforcement levels, YAML frontmatter and progressive disclosure.
10k GitHub starsUsed in 11 repos~3.5k tokens
Agent WorkflowsAuto-check passed
Plugin Settings Pattern
anthropics/claude-plugins-official
Official
Shows how Claude Code plugins keep per-project settings and state in .claude/plugin-name.local.md files with YAML frontmatter and a markdown body.
38k GitHub starsUsed in 7 repos~3k tokens
Agent WorkflowsAuto-check passed
MCP Integration for Plugins
anthropics/claude-plugins-official
Official
Explains how to bundle Model Context Protocol servers in a Claude Code plugin, covering config files, stdio, SSE, HTTP and WebSocket server types, and authentication.
38k GitHub starsUsed in 11 repos~3.1k tokens
Agent WorkflowsAuto-check passed
Claude Code Command Development
anthropics/claude-plugins-official
Official
Explains how to write Claude Code slash commands: Markdown files with YAML frontmatter, arguments, file references, bash context and interactive prompts.
38k GitHub starsUsed in 10 repos~4.8k tokens
Agent WorkflowsAuto-check passed

Questions about OMC HUD Statusline Setup

What does OMC HUD Statusline Setup do?

Installs and configures the oh-my-claudecode heads-up display in the Claude Code statusline, with minimal, focused and full layouts. The skill manages the OMC HUD through subcommands: plain `hud` shows the current status and sets itself up when needed, `setup` installs or repairs it, `minimal`, `focused` (the default) and `full` switch the layout, and `status` prints details.json`, creates the wrapper script and settings if not, and asks you to restart Claude Code after a change.

When should I use OMC HUD Statusline Setup?

OMC HUD Statusline Setup fits situations like: turning on the OMC statusline display for the first time; repairing a HUD that stopped showing after an update; switching between minimal, focused and full HUD layouts.

How do I install OMC HUD Statusline Setup in Claude Code?

Run `npx skills add Yeachan-Heo/oh-my-claudecode --skill hud -a claude-code`. Or copy the skill folder (skills/hud in Yeachan-Heo/oh-my-claudecode) into .claude/skills/hud in your project. Claude Code loads it when a task matches its description.

How do I install OMC HUD Statusline Setup in Codex?

Run `npx skills add Yeachan-Heo/oh-my-claudecode --skill hud -a codex`. Or copy the skill folder (skills/hud in Yeachan-Heo/oh-my-claudecode) into .agents/skills/hud in your project. Codex loads it when a task matches its description.

Can I use OMC HUD Statusline Setup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Yeachan-Heo/oh-my-claudecode --skill hud -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hud, .gemini/skills/hud, .github/skills/hud and .opencode/skills/hud in your project.

What does OMC HUD Statusline Setup need to run?

Going by SKILL.md and its folder, OMC HUD Statusline Setup needs the command-line tools its instructions call (node). Our summary lists: The oh-my-claudecode plugin installed; Node.js to run the HUD script.

Does OMC HUD Statusline Setup access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is OMC HUD Statusline Setup safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does OMC HUD Statusline Setup use?

OMC HUD Statusline Setup is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does OMC HUD Statusline Setup use?

About 2.5k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to OMC HUD Statusline Setup?

Skills that share tags, products or a category with OMC HUD Statusline Setup: Hook Development for Claude Code Plugins (anthropics/claude-plugins-official, 38k stars), Claude Code Agent Development (anthropics/claude-plugins-official, 38k stars), Claude Code Skill Developer Guide (diet103/claude-code-infrastructure-showcase, 10k stars) and Plugin Settings Pattern (anthropics/claude-plugins-official, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains OMC HUD Statusline Setup?

Yeachan-Heo (a GitHub user) maintains it in Yeachan-Heo/oh-my-claudecode, which has 39,751 GitHub stars. The repository holds 47 skills in this directory. The repository was last updated on October 8, 2026.

Source: Yeachan-Heo/oh-my-claudecode on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install OMC HUD Statusline Setup

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

HUD Skill

Quick Commands

Auto-Setup

Setup Instructions (Run These Commands)

Display Presets

Minimal

Focused (Default)

Full

Multi-Line Agent Display

Display Elements

Color Coding

Configuration Location

Manual Configuration

callCountsFormat

safeMode

agentsFormat Options

Troubleshooting

Files

Compare with similar skills

Similar skills

More from Yeachan-Heo/oh-my-claudecode

Related

Questions about OMC HUD Statusline Setup