jarrodwatts /claude-hud
A Claude Code plugin that shows what's happening - context usage, active tools, running agents, and todo progress
★ 29,209⑂ 1,337👁 36⑃ 556● 304▤ 32
+8
日增长
+121
周增长
+619
月增长
29,209
stars
1,337
forks
36
watchers
556
prs
304
issues
32
releases
README
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. !Claude HUD in action 🌐 English | 中文文档 Install Inside Claude Code, run: /plugin marketplace add jarrodwatts/claude-hud /plugin install claude-hud /reload-plugins /hud /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? bash claude plugin marketplace add jarrodwatts/claude-hud claude plugin install claude-hud@claude-hud 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: [Opus] │ my-project git:(main) Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (resets in 1h 30m) - 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: ◐ Edit: auth.ts | ✓ Read ×3 | ✓ Grep ×2 ← tools ◐ explore [haiku]: Finding auth code (2m 15s) ← agents ▸ Fix authentication bug (2/5) ← todos 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 CLAUDE_HUD_DISABLE=1. Security The HUD's logic runs in a locked-down Node process. Node's permission model blocks it from starting programs, reading your credentials, and writing anywhere but its own data folder. An import fence keeps Node's network modules and globals out of its reach; that fence blocks every way out found so far, and is tested against each one on every change. A small separate file runs the fixed git, jj and memory commands it needs. The HUD reads Claude Code's stdin, the session transcript, Claude config files, and git or jj metadata for the current directory, and calls no undocumented APIs. --extra-cmd runs a shell command on every refresh and puts its output on the first
Top issues
#861Windows: hud install from PowerShell writes cmd.exe statusLine that Git Bash mangles3 comments · 2026-11-04#856Feature request: show the current session's peer name (as listed by ListAgents / used by SendMessage)3 comments · 2026-11-02
Latest release
v0.15.0 v0.15.0 2026-11-02Security - A repository's own git config can no longer run a command when you open Claude Code in it. In 0.14.2 and earlier, a booby-trapped repo could do this through a partial clone's automatic fetch, or through a filter driver whose name git couldn't be told to skip. Git now never reaches the network for the HUD, and the HUD skips git for a repo whose filters it can't switch off. Thanks to @yx64 (GHSA-f7gq-pcm8-rxr4) and @mrthankyou (GHSA-25hg-g83m-4w35) for reporting these privately. Changed - /hud replaces /claude-hud:setup and /claude-hud:configure. Ask Claude to set the HUD up, show o