Claude HUD

Claude HUD

A Claude Code plugin that shows what's happening: context usage, rate limits, active tools, running agents, and todo progress, always visible below your input.
🌐 English | 中文文档

Install

Inside Claude Code, run:

/hud checks your setup and points your status line at the HUD, after asking you. It needs Node.js 22.18 or later; if yours is older, /hud finds a newer one on your machine or helps you install one.

Prefer the terminal?

Then run /reload-plugins and /hud inside a session.

Updates: Claude Code doesn't auto-update third-party plugins by default. To turn it on, run /plugin, open Marketplaces, select claude-hud, and choose Enable auto-update. Or update by hand with claude plugin marketplace update claude-hud and claude plugin update claude-hud@claude-hud, then /reload-plugins. You don't need to set it up again.

What You See

The default is two lines:

- Line 1: model, a provider label when one is detected (Bedrock, Vertex, MiniMax), project path, and git branch.
- Line 2: context used (green, then yellow, then red as it fills) and your subscriber rate limits.

Optional lines include tools, agents and todos, plus about a hundred other options:

Change It, Fix It, Report It

Ask Claude, or type /hud and say what you want: "show tool activity", "use the compact layout", "the HUD is blank", "the context bar looks wrong". Claude looks up the options, shows you a preview, and saves the change once you approve it. /hud also undoes the last change, replays the last real render to explain what you see, and, for a real bug, writes a scrubbed report that you read in full before anything is filed.

Settings live in ~/.claude/plugins/claude-hud/config.json (under $CLAUDE_CONFIG_DIR if set). To turn the HUD off for one session, start Claude Code with…