Chrome extension that shows your Claude weekly usage in the browser toolbar — same data source as the macOS and Windows widgets, but as a tiny ring next to the URL bar.
💻 Three versions exist — pick the one for your platform:
- 🍎 macOS → claude-usage-widget
- 🪟 Windows → claude-usage-widget-windows
- 🌐 Chrome (any OS) → you are here
Because the extension runs inside Chrome with cookie access already granted, this version is the simplest to install — no Keychain prompt, no DPAPI, no binary download. Just install from the Chrome Web Store (or load unpacked from this repo).
- Toolbar icon shows your weekly usage % as either a number, a colored donut ring, or your custom emoji
- Popup with the full breakdown: weekly progress bars, 5-hour window, forecast, sparkline trend, account name + plan badge
- Threshold notifications when you cross configurable warn / alert / critical levels (Chrome native notifications)
- Settings page for per-metric display modes + colors, icon picker, refresh interval, notification thresholds
- 15 languages auto-detected from your Chrome locale: English, Türkçe, Español, Français, Deutsch, Italiano, Русский, 日本語, 한국어, 繁體中文, ไทย, Nederlands, Čeština, Українська, Română
- No telemetry, no third-party services. Cookies are sent automatically by Chrome on every request — the extension never reads or stores them.
- Clone this repo or download a release zip
- Open
chrome://extensions/ - Toggle Developer mode in the top-right
- Click Load unpacked and select this folder
- Pin the icon to your toolbar via the puzzle-piece menu
Pending review. Will be listed at https://chrome.google.com/webstore/detail/... once approved.
Right-click the toolbar icon → Options (or open chrome://extensions/ → Claude Usage Widget → Details → Extension options).
| Section | What's there |
|---|---|
| Title content | For each of Weekly %, Weekly remaining, 5-hour %, 5-hour remaining: hide / show as text / show as a donut. Pick from 8 swatch colors when donut. |
| Icon | Emoji preset (🤖🧠⚡✨◉●▲◐), custom emoji, donut summary, or no icon. |
| Refresh interval | 30 s · 1 min · 5 min · 10 min |
| Notifications | Toggle threshold alerts. Three configurable levels (warn / alert / critical) fire Chrome notifications when crossed. Each level fires once per week. |
| Permission | Why it's needed |
|---|---|
storage |
Save your settings + cached usage |
alarms |
Periodic refresh and history sampling |
notifications |
Threshold alerts |
host_permissions: claude.ai/* |
Send your existing cookie to claude.ai's usage API (no other site touched) |
host_permissions: api.github.com/repos/turkbil/* |
Daily version-check against this repo's Releases (disable-able) |
The extension never reads or transmits your cookies. Chrome attaches them automatically on credentials:'include' requests to claude.ai — same as any web page would.
- No analytics, no telemetry. Only outbound traffic is HTTPS to
claude.ai(data) and once per day toapi.github.com(release check). - No data sent to third parties. No Sentry, no PostHog, no Mixpanel.
- Local storage: preferences + a 14-day usage history sample (capped at 4032 entries, ~70 KB).
- See PRIVACY.md for the formal policy.
Auto-detects Chrome's UI language and falls back to English.
| 🇬🇧 | English (default) |
| 🇹🇷 | Türkçe |
| 🇩🇪 | Deutsch (PR welcome) |
| 🇪🇸 | Español (PR welcome) |
| 🇫🇷 | Français (PR welcome) |
Built by Nurullah Okatan — nurullah.net · @nurullah
MIT © Nurullah Okatan
Not affiliated with Anthropic. "Claude" is a trademark of Anthropic.