Track your Claude AI usage limits directly from the browser toolbar. Monitor 5-hour session and 7-day quotas with real-time progress rings. Never hit the limit unexpectedly again.
- Dual Progress Rings — See both session (5-hour) and weekly (7-day) limits at a glance
- Color-Coded Status — Green, yellow, orange, and red indicators show usage levels
- Real-Time Updates — Automatically refreshes every 5 minutes
- Visual Warnings — Animated rotating icon when approaching limits (70%+)
- Tips & Tricks — 40+ built-in prompting tips to use Claude more effectively
- Auto-Detect — Automatically finds your Claude organization, no setup needed
- Premium Dark Theme — Beautiful, native-feeling interface
- Privacy First — All data stays on your device. No tracking, no analytics.
Coming soon.
- Download or clone this repository
- Go to
chrome://extensions/(or equivalent) - Enable "Developer mode"
- Click "Load unpacked"
- Select the
srcfolder
- Download or clone this repository
- Go to
about:debugging#/runtime/this-firefox - Click "Load Temporary Add-on"
- Select
src/manifest.json
- Log in to Claude.ai — The extension needs your active session
- Click the extension icon — View your detailed usage stats
- Pin it to your toolbar — The icon color shows your usage level at a glance
The toolbar icon shows two concentric rings:
| Ring | Tracks |
|---|---|
| Outer ring | 7-day weekly limit (all models) |
| Inner ring | 5-hour session limit |
| Usage Level | Color | Meaning |
|---|---|---|
| 0–50% | Green | Plenty of usage remaining |
| 50–70% | Yellow | Moderate usage |
| 70–90% | Orange | Getting close to limit |
| 90–100% | Red | Near or at limit |
At 70%+, the icon animates (rotating rings) to grab your attention.
src/
├── manifest.json # Extension manifest (MV3)
├── background/
│ └── service-worker.js # Central orchestrator
├── content/
│ └── content.js # Fallback DOM scraping
├── popup/
│ ├── popup.html # Popup structure
│ ├── popup.css # Dark theme styles
│ └── popup.js # Popup logic & tips
├── tips/
│ ├── tips.html # Tips & Tricks page
│ ├── tips.css
│ └── tips.js
├── welcome/
│ ├── welcome.html # Welcome & pin instructions
│ ├── welcome.css
│ └── welcome.js
├── lib/
│ ├── constants.js # Colors, thresholds, config
│ ├── storage.js # Storage abstraction
│ └── icon-renderer.js # Dynamic icon with OffscreenCanvas
├── icons/
│ └── icon-{16,32,48,128}.png
├── _locales/
│ └── en/messages.json
└── browser-polyfill.min.js # Cross-browser support
- All data stored locally in your browser
- No data sent to third-party servers
- Uses your existing Claude.ai session (no passwords stored)
- Minimal permissions requested
- Open source — full code transparency
Full privacy policy: PRIVACY.md
| Permission | Reason |
|---|---|
storage |
Store cached usage data locally |
alarms |
Schedule periodic data refresh (every 5 minutes) |
offscreen |
Generate dynamic toolbar icons |
host_permissions: claude.ai |
Fetch usage data from Claude's API |
- Dual progress rings (5-hour session + 7-day weekly)
- Dynamic toolbar icon with color-coded status
- Rotating animation warning at 70%+ usage
- Auto-detect organization ID
- Tips & Tricks page with prompting best practices
- Random tip display in popup
- Premium dark theme UI
- Welcome page with pin instructions
- Desktop notifications at configurable thresholds (70%, 90%, 100%)
- Badge text on toolbar icon showing percentage
- Sound alerts (optional, with mute)
- "Do not disturb" quiet hours setting
- Usage history graph (daily/weekly trends)
- Calendar heatmap (GitHub-style activity view)
- Usage predictions ("At this rate, limit in ~2h")
- Peak usage hours analysis
- Export data (CSV/JSON)
- Light theme option
- Custom accent colors
- Configurable refresh intervals
- Keyboard shortcut to open popup
- Multiple Claude account support
- Sync settings across devices (Chrome sync)
- Firefox Add-ons store release
- Microsoft Edge Add-ons store release
- Localization (FR, DE, ES, PT, JP)
- Teams/Organization view
- Desktop widgets (macOS/Windows)
- Slack/Discord bot for usage alerts
- Usage budgets and smart suggestions
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes
- Push to the branch
- Open a Pull Request
Have a feature idea? Open an issue with the enhancement label.
- Make sure you're logged into Claude.ai in the same browser
- Click the refresh button in the popup
- Check that you're logged into claude.ai
- Make sure all files are present in the
src/folder - Check the browser's extension error log
MIT License — see LICENSE file
Note: ClaudeKarma is an independent project and is not affiliated with Anthropic.
Made with care by Jean-Rémi Larcelet-Prost