← All tools
Usage HUD Free Claude Code plugin

Know your limits
before the next prompt.

See plan usage, context, cache and estimated cost right above your Claude Code prompt.

Free · Open source · MIT licensed

The quiet view
Usage HUD bar showing plan usage, context, cache countdown and estimated cost
The detailed view
Limits, Context, Cache and Session cards with demo usage

Click either view to enlarge. Dollar amounts are indicative API-price estimates, not a bill.

01 / Limits

Limits with pace

5-hour and weekly use, reset times in your own time zone, and projections of when your current pace could hit the limit.

02 / Context

Context at a glance

Tokens in the window, split by what fills it, with the autocompact reserve marked.

03 / Cache

Cache countdown

See how long the prompt cache is expected to stay warm before a pause gets expensive.

04 / Estimates

Estimated session cost

What the session would cost at API prices. On a subscription, this is an estimate, not a charge.

Install

Two commands.
Then you're set.

Needs Claude Code 2.1.289 or later.

Then restart Claude Code, or run /reload-plugins. Type /hud to open the cards.

Read-only plugin. No telemetry or network calls of its own. MIT licensed.

Terminal
claude plugin marketplace add rsvishalsingh93/claude-usage-hud
claude plugin install usage-hud@claude-usage-hud

Keep it tidy

Update, remove
or get unstuck.

Update Usage HUD
Terminal
claude plugin marketplace update claude-usage-hud
claude plugin update usage-hud@claude-usage-hud

Restart Claude Code or run /reload-plugins.

Uninstall Usage HUD
Terminal
claude plugin uninstall usage-hud@claude-usage-hud
claude plugin marketplace remove claude-usage-hud

The bar isn't showing

Check that Claude Code is version 2.1.289 or later, restart it or run /reload-plugins, then wait for the first reply. Some values appear only once this run has usage to show. Use /hud to open the cards.

Read the product documentation ↗

More from the same maker

Our other apps