Usage
Claude subscription limits and token counts on four pages, read from a console on your server. The device holds no Anthropic login.
- Home key: u
- Needs: Needs your server
- Source: Your console, /usage
- Offline: Last reading, with its age
Usage asking the server. Four pages follow: limits, today, the week, and where tokens went.
The four pages
Left and Right page through them.
| Page | Shows |
|---|---|
| Limits | The 5 hour, weekly and per-model weekly windows as bars with reset times, where the numbers came from, and how old they are. |
| Today | Output, input and cache tokens, replies and sessions, by model. |
| Week | Output tokens per day as a bar chart. |
| Where | Tokens this week by working folder, so you can see which project or agent used them. |
Press u to refetch, skipping the console's one minute cache.
Elsewhere on the device
- The clock and lock face can carry a usage line. It reads the cache and fetches once only when the cache is over fifteen minutes old and the server answered last.
- Ask's footer shows the line after each answer.
- Home puts a
!on Usage when a limit passes 80 percent.
A per-model weekly limit can run out well before the overall one, which is why both are shown.
How it works
The gate's usage shape fetches the console's /usage or /usage/refresh on the server with the console token, which never leaves the server. The console decides where the numbers come from and throttles any request to Anthropic, so asking often from the device does not mean asking Anthropic often.
Needs on the server
A web service on your server that answers /usage and /usage/refresh with Claude usage as JSON, behind the same token as Glance. PennyOS does not include one. Without it, Usage has nothing to show.