claude-usage-overlay
Claude Usage Overlay
Discrete progress bars integrated into the Claude.ai prompt footer showing your 5-hour session and 7-day weekly usage caps, with reset times. Local-only, zero telemetry.
Unofficial third-party extension. Not affiliated with Anthropic.
What it shows
A discrete strip integrated into the bottom of the Claude.ai prompt input box:
Session: 22.8% · resets at 16:43 [████░░░░░░] [████████░░] Weekly: 78.5% · resets lun 05:00
| Field | Meaning |
|---|---|
| Session | Rolling 5-hour session utilization (0-100%) + reset hour |
| Weekly | Rolling 7-day weekly utilization (0-100%) + day + reset hour |
These are the only two usage windows Claude.ai exposes. This extension does not synthesize fake “daily” or “monthly” numbers.
The progress bars are color-coded:
- 🟢 Green: ≤70% (comfortable)
- 🟡 Amber: 71-89% (heads up)
- 🔴 Red: ≥90% (about to hit the cap)
Why this exists
The Claude.ai web interface shows usage caps only if you navigate to
Settings → Usage. There are other extensions that surface this
inline, but the popular ones either sync your data through third-party
backends or request more browser permissions than the use case
justifies.
This extension is the minimal alternative:
- 100% local. No backend, no telemetry, no analytics.
- Two permissions only:
storageandhttps://claude.ai/*. - Auditable — the entire codebase is a single content script.
- MIT licensed.
- Automatic fallback to a draggable floating overlay if claude.ai changes its DOM and the embedded UI can’t attach.
Install
From source (current)
- Download the latest release zip from Releases
- Unzip somewhere permanent on disk
- Open
chrome://extensions/(orbrave://extensions/,edge://extensions/) - Enable “Developer mode” (top-right)
- Click “Load unpacked” and select the unzipped folder
- Visit https://claude.ai — the strip appears at the bottom of the prompt box
From the Chrome Web Store
Not currently published.
Use
- The strip appears integrated at the bottom of the prompt input, matching the page styling
- If claude.ai changes its DOM and the strip can’t attach, a small green floating overlay appears in the bottom-right corner instead (draggable; position persists)
Privacy
The extension does not collect, transmit, or share any data with
anyone, including the developer. All persistence is local to the
browser via chrome.storage.local.
Full policy: PRIVACY_POLICY.md
Permissions
| Permission | Why |
|---|---|
storage |
Cache last snapshot, org UUID, overlay position |
https://claude.ai/* |
Inject the UI and read usage data from claude.ai |
The extension does not request tabs, scripting, webRequest,
cookies, or any host beyond claude.ai.
Caveat: undocumented endpoint
The /api/organizations/{uuid}/usage path consumed by this extension
is not part of Anthropic’s public API. If Anthropic changes the
endpoint, the extension will break until updated.
If that happens, please open an issue
with the JSON shape from claude.ai/settings/usage (DevTools →
Network → filter “usage”) and the parser can be adapted quickly.
Authorship
Designed and maintained by actuario.
Code authored in collaboration with Claude (Anthropic’s AI assistant). The AI assistant is not a publisher of this extension and bears no responsibility for its operation.
Contributing
Issues and pull requests are welcome. See CONTRIBUTING.md for guidelines on what’s in and out of scope.
License
MIT.
“Claude” and “Anthropic” are trademarks of Anthropic, used here descriptively to indicate the service this extension monitors. The icon is a generic four-pointed sparkle, not Anthropic’s logo.