Claude HUD plugin
A Claude Code plugin that puts context usage, active tools, running subagents and todo progress into the statusline
- 29,182 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Runs a Node.js statusline script after every agent action
- Reads the session transcript, calls git and, if configured, runs your own command for an extra line
- Reads the plan name and account name from ~/.claude.json for display
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/claude-hudDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Runs a Node.js statusline script after every agent action
- Reads the session transcript, calls git and, if configured, runs your own command for an extra line
- Reads the plan name and account name from ~/.claude.json for display
This is third-party code. Review the repository files before installing.
What it does
The plugin keeps a live session summary in the Claude Code statusline. By default it shows two lines: the model, a provider label when it is confidently identified, the project path and the git branch, then a bar for context usage and rate limits. Token figures come straight from Claude Code rather than being estimated, and the bar scales to the context window size, up to million-token sessions. Optional lines add tool activity, subagent status and todo progress, all read from the session transcript. It runs through the built-in statusLine API, with no separate window and no tmux, and re-renders after each interaction.
Who it is for. For developers who want to see the state of a Claude Code session right in the terminal.
Good fit when
- You want to watch context usage and compact history in time
- You want to see which tools and subagents are running right now
- You want todo progress and rate limits without a separate window
Not a fit when
- You work outside Claude Code, in an agent without the statusLine API
- Your statusline already runs a script you do not want to replace
Example request
Change the claude hud statusline layout and add the todo progress lineLimitations
The plugin targets Claude Code and its statusLine API, it displays what the agent reports about the session and adds no new capabilities to the agent itself. Windows setup needs Node.js LTS. On older Claude Code versions the statusline appears only after a restart, and on Linux with a separate filesystem for tmp the plugin install could previously fail with an EXDEV error.
How to disable. Remove the plugin via /plugin, then delete or replace the statusLine entry in the Claude Code settings file that /claude-hud:setup added.
FAQ
Are the context numbers accurate?
The plugin uses token data straight from Claude Code rather than estimating it, and scales the bar to the context window size, including million-token sessions.
Do I need a separate window or tmux?
No. The plugin uses the built-in statusLine API and prints the line in the terminal itself.
Discussion
No questions or reviews yet.
Related
PluginsA dependency-free Node.js status line for Claude Code showing model, git branch, context, cache and subscription limits.
A Claude Code status line displays the current model, Git state and context usage directly in the terminal
A set of Claude Code mods: status lines above the prompt, a guard against risky commands and a few small games
A marketplace of small Claude Code plugins: path previews, context and token meters, a smart /commit and turn rollback.
A Rust status line for Claude Code with Classic, Powerline and Capsule themes: tokens, git branch, cost and subscription limits.
Three Claude Code plugins: the savvy-flow orchestrator with tiered subagents and two mods for a progress panel and a cache timer
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| Claude HUD (this card) | no | 29,182 | |
| Claude Powerline | no | 1,177 | a statusline for Claude Code |
| claude-dashboard | no | 587 | a Claude Code plugin |
| Token Tracker | no | 536 | counts token use and cost of Claude Code and Codex sessions from |
README in short
The README describes the Claude HUD plugin and a three-step install: add the marketplace, install the plugin, run /claude-hud:setup to configure the statusline. By default it shows two lines with the model, project path, branch and context and usage bars, and /claude-hud:configure enables tool, subagent and todo lines. It also covers terminal install via the Claude Code CLI and fixes for common Windows and Linux issues. A Chinese README translation is included. MIT licensed.