Repolode
Submit
jarrodwatts

jarrodwatts/claude-hud

A Claude Code plugin that adds a live status line showing context usage, rate limits, active tools, running agents, and todo progress.

View on GitHub
Stars
28,657
Forks
1,417
Open issues
0
Last commit
yesterday

What is it?

Claude HUD is a plugin for Claude Code that renders a heads-up display below the input prompt. The default view shows the active model, project path, git branch, how full the context window is, and subscriber usage limits. Optional lines can add recent tool calls, running subagents, and todo progress taken from the session transcript.

It runs as Claude Code's status line command. Claude Code pipes session data such as model, context window, cost, and rate limits to it on stdin, and the plugin prints the formatted output. It needs no separate window or tmux and works in any terminal on macOS, Linux, and Windows.

Nearly every element is configurable through a guided /claude-hud:configure flow or a config.json file. Options cover layout, colors, language (English, Simplified or Traditional Chinese), git and jj status, cost display, usage pacing, and token breakdowns.

Key features

  • 01Shows context window usage as a bar and percentage, colored as it fills.
  • 02Displays subscriber rate limits, including the 7-day window, with reset countdowns.
  • 03Lists recent tool calls, running subagents, and todo progress as optional lines.
  • 04Shows git branch and dirty state, or jj status for Jujutsu repositories.
  • 05Offers compact and expanded layouts with configurable element order and colors.

Use cases

  • Keeping an eye on how full the context window is during long coding sessions.
  • Tracking which tools and subagents Claude Code is running without scrolling the transcript.
  • Watching subscriber usage limits so you know when they reset.
  • Following todo progress on multi-step tasks.

Quick start

  1. 1

    Add the marketplace inside Claude Code

    /plugin marketplace add jarrodwatts/claude-hud
  2. 2

    Install the plugin

    /plugin install claude-hud
  3. 3

    Reload plugins

    /reload-plugins
  4. 4

    Point the status line at the HUD

    /claude-hud:setup

Things to know

  • Requires Node.js on Windows; if setup reports no JavaScript runtime, install Node.js LTS first.
  • Some optional elements such as the tools, agents, and todos lines read the session transcript.
  • Claude Code does not auto-update third-party plugins by default, so updates may need to be run manually.

Topics

#claude-code#statusline#cli#developer-tools#ai-coding#plugin#terminal#anthropic#claude#typescript

FAQ

What is claude-hud?
A Claude Code plugin that adds a live status line showing context usage, rate limits, active tools, running agents, and todo progress. Claude HUD is a plugin for Claude Code that renders a heads-up display below the input prompt. The default view shows the active model, project path, git branch, how full the context window is, and subscriber usage limits. Optional lines can add recent tool calls, running subagents, and todo progress taken from the session transcript.
Is claude-hud free to use? What license does it have?
claude-hud is open source under the MIT license. Check the license terms before using it in commercial products.
Is claude-hud still maintained?
Actively maintained. The last commit to claude-hud was on Oct 19, 2026.
What can I use claude-hud for?
Keeping an eye on how full the context window is during long coding sessions. Tracking which tools and subagents Claude Code is running without scrolling the transcript. Watching subscriber usage limits so you know when they reset. Following todo progress on multi-step tasks.
How do I install claude-hud?
Add the marketplace inside Claude Code: /plugin marketplace add jarrodwatts/claude-hud Install the plugin: /plugin install claude-hud Reload plugins: /reload-plugins Point the status line at the HUD: /claude-hud:setup
Where can I get claude-hud?
The source code and installation instructions are on GitHub: https://github.com/jarrodwatts/claude-hud

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects