Displays Claude.ai session and weekly usage stats as a floating overlay while you chat.
# Claude Usage Overlay
A Tampermonkey userscript that displays your Claude.ai usage stats as a floating overlay while you chat.
## Features
- Shows current session usage (%) and reset time
- Shows weekly usage (%) and reset time
- Auto-refreshes every 5 minutes
- Click the overlay to manually refresh
## How It Works
Since `claude.ai` is a React SPA, usage data is not available in the raw HTML from `fetch()`. Instead, this script loads `/settings/usage` in a hidden iframe and waits for React to finish rendering, then reads the `aria-valuenow` attributes from the progress bar elements.
No extra API calls or tokens are consumed — it's equivalent to opening the settings page in a browser tab.
## Installation
1. Install [Tampermonkey](https://www.tampermonkey.net/)
2. Click **Install** on the Greasy Fork page
3. Open any `claude.ai/chat/*` page — the overlay appears in the bottom-right corner
## Author
tac-tac-go
## License
MIT
