CLAUSEAGE

A compact floating widget that displays your Claude AI usage limits in real time on chat pages

ही स्क्रिप्ट इंस्टॉल करा ?

Visit the author's site for support, ask a question, post a review, or report the script.

लेखक

Yorkian

दैनिक इंस्टॉल

एकूण इंस्टॉल

रेटिंग

0 0 0

आवृत्ती

1.0.0

बनवली

2026-04-04

अपडेट केली

2026-04-04

आकार

21.6 KB

License

MIT

यांवर लागू होते:

claude.ai

CLAUSEAGE

A compact floating widget that displays your Claude AI usage limits in real time — right on your chat page.

No more switching tabs to check how much quota you have left.

What It Shows

Current session — percentage used, progress bar, time until reset
Weekly limits — percentage used, progress bar, next reset day
Plan badge — your subscription tier displayed in the title bar (e.g. CLAUSEAGE | Pro)
Extra usage — only appears when your Current balance is above $0
Live countdown — "Updated: just now" → "half a minute ago" → ... → "Refreshing soon"

Features

🎯 Chat-only — appears exclusively on claude.ai/chat/* pages, zero interference elsewhere
🔄 Auto-refresh — silently updates every 5 minutes; manual refresh anytime via the ↻ button
🖱️ Draggable — move it anywhere on screen, vertical position is remembered across sessions
➖ Minimizable — collapse to a tiny header bar when you need more space
🌙 Dark mode — adapts to your system theme and Claude's own dark mode
🔒 Privacy-first — no data leaves your browser, no external servers, no tracking, zero permissions

How It Works

CLAUSEAGE injects a hidden same-origin iframe loading claude.ai/settings/usage, waits for React to render the usage data, parses the DOM, and displays the results in the floating widget. The iframe is destroyed immediately after extraction.

It also monkey-patches history.pushState / replaceState and listens for popstate to handle Claude's SPA navigation — so the widget correctly appears and disappears as you move between chat and non-chat pages.

If you're not logged in, the widget stays hidden.

Technical Notes

Manifest V3 — no background service worker, no special permissions, content script only
Same-origin iframe — since the widget runs on claude.ai, the iframe to /settings/usage is same-origin and accessible via contentDocument
DOM polling — polls the iframe every 500ms (up to 20s) waiting for "% used" text to appear, indicating React has finished rendering
Position persistence — vertical position saved to localStorage; horizontal position always snaps to the right edge on window resize
Auto-refresh timer — setInterval at 5 minutes; resets on manual refresh to avoid double-fetching

Compatibility

Chrome / Chromium-based browsers (Edge, Brave, Arc, etc.)
Manifest V3
Requires an active claude.ai session

Privacy

CLAUSEAGE does not collect, transmit, or store any personal data. All processing happens locally in your browser. The only data stored is the widget's screen position via localStorage.

Full privacy policy

License

MIT

Author

York — @Yorkian