Skip to content
Get packs

HUD Statusline Configurator

Installs and configures a heads-up statusline display for Claude Code showing session, agent and task status

Source Download skill
Repository
Yeachan-Heo/oh-my-claudecode
Stars
40,512
Licence
MIT
Files
1 file

What it does

This skill sets up and customises a status bar (the HUD) that appears in Claude Code and shows things like the git branch, context window usage, running subagents and todo progress. When you run it, the agent copies a wrapper script and a helper file into your ~/.claude folder, edits your settings.json to point the statusline at that script, and tells you to restart Claude Code. You can also switch between minimal, focused and full display presets.

Great for

  • Claude Code users of the oh-my-claudecode plugin who want more visibility into agent activity
  • Developers who run long sessions with multiple subagents and want to see context usage at a glance

Skip it if

  • People who do not use the oh-my-claudecode plugin, since the HUD reads plugin files and will report it as not installed
  • Users on shared machines who do not want their ~/.claude/settings.json modified, because the skill rewrites the statusLine field and copies scripts into that folder

Try asking

  • “/oh-my-claudecode:hud setup”
  • “/oh-my-claudecode:hud minimal”
  • “/oh-my-claudecode:hud full”
  • “/oh-my-claudecode:hud status”
Step-by-step guide: how to use HUD Statusline ConfiguratorInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    hud.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip hud.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip hud.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Run status first to check whether setup is already complete before running setup again
  • Restart Claude Code after setup so the new statusline takes effect
  • On Windows, make sure the statusLine command uses forward slashes in the path

What's inside

  • SKILL.md

Redistributed unmodified from Yeachan-Heo/oh-my-claudecode under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.