Monitors the Claude usage page and notifies on every 5% increase in plan consumption.
Monitors the Claude usage page (claude.ai/settings/usage) and sends a notification each time plan consumption crosses a
5 % threshold (5, 10, 15, 20 ... %).
Features
- Auto-detects French and English UI on the Claude page; notification text follows navigator.language.
- Uses GM_notification with a unique tag so a new threshold replaces the previous notification instead of stacking up.
- Stays armed even when the browser window is minimized: polling runs inside a Web Worker to bypass background-tab timer
throttling.
- Detects SPA navigation (pushState / replaceState / popstate), so the notification fires as soon as you land on
/settings/usage, even from another route on claude.ai.
- Optional sound cue (880 Hz, ~400 ms, generated via the Web Audio API), toggled from the Violentmonkey / Tampermonkey
extension menu - useful on Firefox where OS notifications are short-lived.
- Persistent settings via GM_setValue (no localStorage pollution).
Permissions
- GM_notification - desktop notifications
- GM_registerMenuCommand - sound toggle in the extension menu
- GM_setValue / GM_getValue - persistent settings
Privacy
The script reads the percentage and reset countdown directly from the DOM of the official Claude usage page. No network
request, no third-party service, no telemetry.
Compatibility
Tested on Firefox + Violentmonkey and Chrome + Tampermonkey.
- Chrome + Tampermonkey: fully persistent OS notifications (kept until clicked).
- Chrome + Violentmonkey: persistent thanks to the onclick parameter.
- Firefox + Violentmonkey: notifications fire but are short-lived (Firefox limitation, Bugzilla #1187270). Enable the
sound option for a reliable signal when the window is minimized.
