What is Claude HUD?
Claude HUD is a Claude Code plugin that shows what is happening in a session: context usage, rate limits, active tools, running agents and todo progress, always visible below your input. It is released under the MIT license.
The default display has two lines. Line 1 shows the model, a provider label when one is detected such as Bedrock or Vertex, the project path and the git branch. Line 2 shows context used, colored green, then yellow, then red as it fills, and your subscriber rate limits. Optional lines add tools, agents and todos.
Install it inside Claude Code with /plugin marketplace add jarrodwatts/claude-hud, then /plugin install claude-hud, /reload-plugins and /hud. The /hud command checks your setup and points your status line at the HUD after asking you. It needs Node.js 22.18 or later. Settings live in ~/.claude/plugins/claude-hud/config.json, and CLAUDE_HUD_DISABLE=1 turns it off for one session. The README describes the core logic as running in a locked-down Node process that cannot start programs, read credentials or write outside its own data folder.
Key capabilities
- Session line Model, provider label, project path and git branch.
- Usage line Context use and subscriber rate limits.
- Optional lines Tool activity, running agents and todo progress.
- Guided setup The /hud command asks before changing your status line.
- Restricted process A permission-limited Node process for the display logic.
Where Claude HUD fits
- Watching context fill during long Claude Code sessions
- Seeing rate-limit use and reset time
- Following subagents and todos while they run
- Changing the layout by asking Claude or using /hud
Install
/plugin marketplace add jarrodwatts/claude-hudReviews of Claude HUD
Be the first to share your experience with Claude HUD.
Write a review
Loading review form…
Alternatives to Claude HUD
CLI-AnythingCLI-Anything generates Python command-line interfaces for existing software so AI agents can operate it, with CLI-Hub for discovering and managing tools.CBClaude BlogClaude Blog is an open-source Claude Code plugin for sourced blog writing, SEO checks, multilingual content and editorial audits, with automated checks that can block delivery.