Troubleshooting Guide
Claude Usage Meter
The usage gauge isn't appearing
The most common issue — the gauge requires an SSE event to initialize.
The usage gauge hooks into Claude's SSE completion stream — the real-time feed that delivers Claude's responses. It can only appear after Claude has started generating a response in your session. If you've just opened the page without sending a message, the gauge has nothing to hook into yet.
How to Fix It:
- Make sure you are on claude.ai and signed in.
- Send a message to Claude and wait for it to start responding.
- The gauge should appear next to the model selector as Claude replies.
- If it still doesn't show, do a hard refresh (Cmd+Shift+R / Ctrl+Shift+R) and try again.
Usage data stopped updating mid-conversation
The SSE listener can drop if the page partially reloads or Claude's interface updates.
If Claude.ai navigates to a new conversation or the page state resets, the SSE listener needs to re-attach. This can look like the countdown timer freezing or the gauge showing stale numbers.
How to Fix It:
- Reload the page with Cmd+R / Ctrl+R.
- Send a new message to Claude — this re-triggers the SSE stream the extension listens to.
- If the timer shows an obviously wrong number, the extension may have lost its baseline. Reload the page to recalibrate.
Threshold alerts aren't firing
Alerts fire at 80% and 100% of your session limit. If you jumped past a threshold in a single large response, the alert for the lower threshold may have been skipped.
- Check the sidebar widget — it shows your current utilization percentage directly.
- Alerts are per-session. If you crossed 80% in a previous session and started a new one, the alert resets.
- Make sure the extension is not paused or disabled for claude.ai in Chrome's extension settings.
Chat export is missing messages or artifacts
The exporter captures the conversation state loaded in your current tab. If Claude is still generating a response when you click export, the in-progress message may be incomplete or absent.
- Wait for Claude to finish responding before triggering the export.
- For very long conversations, scroll to the top and bottom of the page to ensure the full thread is loaded in the DOM before exporting.
- If an artifact is missing from the ZIP, try opening the artifact in Claude first — some lazy-load only when you interact with them.