Skip to content
Get packs

Claude HUD

A status line plugin for Claude Code that shows context use, rate limits, active tools, agents, and todos.

GitHub Download v0.15.0
Stars
29.1k
Forks
1.3k
Licence
MIT
Language
JavaScript
Last update
4 days ago
Type
App

What it is

Claude HUD is a plugin for Claude Code, Anthropic's coding assistant. It adds a status display below the input box that shows how full the context window is, your subscriber rate limits, the current model, project path, and git branch. Optional lines can also show which tools are running, which agents are active, and todo progress. It runs as a status line command, so it needs no separate window.

  • See how much of the context window is used while a session runs
  • Check subscriber rate limit usage and when it resets
  • Watch which tools, such as Edit or Read, Claude is calling
  • Follow running agents and todo completion in the status line
  • Show git branch and uncommitted-change markers in the HUD

Great for

  • Developers who use Claude Code daily and want to see context usage at a glance
  • People on subscriber plans who want to track rate limits while working
  • Users who run several agents or long tasks and want to follow progress
  • Anyone who wants a configurable status line without extra software

Not ideal for

  • People who do not use Claude Code, since the plugin only works inside it
  • Users who want automatic updates by default, because Claude Code does not auto-update third-party plugins unless you turn that on
  • Windows users without Node.js installed, because the setup step needs a JavaScript runtime
Step-by-step guide: how to use Claude HUDInstall, first run, examples, tips and FAQs
Claude HUD alternativesClaude HUD vs OmniRouteClaude HUD vs MCP for Unity

How to get it

  1. 1

    See the README

    You'll need: Claude Code · Node.js LTS (needed on Windows if setup reports no JavaScript runtime)

    Add the plugin marketplace inside Claude Code

    /plugin marketplace add jarrodwatts/claude-hud

    Install the plugin inside Claude Code

    /plugin install claude-hud

    Reload plugins inside Claude Code

    /reload-plugins

    Point the status line at the HUD inside Claude Code

    /claude-hud:setup
  2. 2

    Run it

    • Open Claude Code in a project folder
    • Run /plugin marketplace add jarrodwatts/claude-hud, then /plugin install claude-hud
    • Run /reload-plugins and then /claude-hud:setup
    • The two-line HUD should appear below your input
    • Optionally run /claude-hud:configure to turn on tools, agents, or todos lines
  3. 3

    Get the most out of it

    • Use /claude-hud:configure to turn on optional tools, agents, and todos lines
    • Set gitStatus options such as showFileStats or showAheadBehind in config.json
    • Use lineLayout set to compact for a single-line display
    • Use display.customLine or a per-directory claude-hud.json when running multiple CLAUDE_CONFIG_DIRs
    • Set language to zh-Hans or zh-Hant for Chinese labels

Downloads

Source code (.zip)main branch · straight from GitHubRelease v0.15.0Release notes and source

Strengths

  • Installs with a few commands inside Claude Code and includes a guided configure flow
  • Configurable layout, element order, and git display options documented in the README
  • MIT licensed and actively maintained, with a recent push date

Trade-offs

  • Optional lines depend on reading the session transcript, so behavior is tied to Claude Code internals that may change
  • Configuration has many options, which can be hard to navigate for newcomers
  • README is truncated in the source provided, so some details could not be verified

How it compares

ProjectStarsTypeLevelUpdatedBest for
claude-hud (this)29.1kAppbeginner4 days agoDevelopers who use Claude Code daily and want to see context usage at a glance
OmniRoute83.8kAppintermediate4 days agoDevelopers who use several AI coding tools and want one place to configure providers
ECC295kDev toolintermediate4 days agoDevelopers who already use Claude Code and want a shared workflow for planning, testing and review
hermes-agent260kAI model / agentintermediate4 days agoDevelopers who want a personal agent they can host on their own server or machine
agents42.1kDev toolbeginner4 days agoDevelopers who already use one of the listed AI coding tools and want ready-made specialist agents
claude-code-templates33.1kCLIbeginner4 days agoDevelopers who already use Claude Code and want ready-made agents or commands without writing them from scratch

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.