Skip to content
Back to search

claude-usage-band

MarketplaceWorks with Claude CodeGitHub

A soft, modern usage card above the Claude Code prompt: remaining limits as slim gradient bars with reset times

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/idanam2--claude-usage-band/badge.svg)](/listings/idanam2--claude-usage-band)

HTML

<a href="/listings/idanam2--claude-usage-band"><img src="/api/listings/idanam2--claude-usage-band/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

At the prompt of a terminal session:

/plugin install usage-band --marketplace idanam2/claude-usage-band

From a shell:

claude plugin install usage-band --marketplace idanam2/claude-usage-band

In the desktop app, where `/plugin` does not run: click **+** next to the prompt box, then **Plugins**, **Add marketplace** with `idanam2/claude-usage-band`, then **Add plugin**.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 5 lines
  1. {
  2. "name": "claude-usage-band",
  3. "owner": { "name": "idanam2" },
  4. "plugins": [{ "name": "usage-band", "source": "./", "description": "A soft, modern usage card above the Claude Code prompt" }]
  5. }
README.md · README · 41 lines
  1. # usage-band
  2. A soft, modern usage card that sits right above the Claude Code prompt.
  3. ![usage-band in light and dark mode](docs/preview.png)
  4. - **Remaining usage, not used.** Each limit (5-hour session, weekly, spend) is a slim gradient bar with a big "% left".
  5. - **Reset time at a glance.** `resets in 2h 14m` under every bar.
  6. - **Calm colors that warn.** Teal when you have plenty, amber under 30%, rose under 10%.
  7. - **Light and dark.** The card is translucent and follows the app's mode.
  8. - **Terminal friendly.** In a plain terminal (no graphics) it falls back to compact text bars.
  9. It is a Claude Code "mod": one hook on the `AbovePrompt` slot, a few dozen lines, no dependencies, and it reads only the rate-limit numbers Claude Code already has. Nothing is sent anywhere.
  10. ## Install
  11. At the prompt of a terminal session:
  12. ```
  13. /plugin install usage-band --marketplace idanam2/claude-usage-band
  14. ```
  15. From a shell:
  16. ```
  17. claude plugin install usage-band --marketplace idanam2/claude-usage-band
  18. ```
  19. In the desktop app, where `/plugin` does not run: click **+** next to the prompt box, then **Plugins**, **Add marketplace** with `idanam2/claude-usage-band`, then **Add plugin**.
  20. ## Customize
  21. Everything visual lives in [`hooks/bar.ts`](hooks/bar.ts): sizes, labels, the three color tones and the SVG styles. `hooks/register.tsx` only feeds it the numbers.
  22. ## Credits
  23. Inspired by the status-line projects the community loves: [claude-hud](https://github.com/jarrodwatts/claude-hud) and [ccstatusline](https://github.com/sirmalloc/ccstatusline).
  24. ## License
  25. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.