Feature request: programmatic/scriptable way to check current Pro/Max weekly usage quota
Body:
Is your feature request related to a problem? Please describe.
Right now, the only way to see how much of my weekly Claude Pro/Max usage quota I've used is to check the claude.ai website UI manually. There's no CLI command, flag, or API endpoint that returns this as structured/scriptable data. The /usage slash command in Claude Code shows usage info interactively, but it's meant for reading in the terminal, not for parsing or automation.
Describe the solution you'd like
A scriptable way to fetch current weekly quota usage (e.g. percent used, reset date/time), such as:
- A
claude usage --jsonCLI flag that outputs the same data/usageshows, in JSON. - Or an API endpoint (authenticated with the same session/account used by Claude Code or claude.ai) that returns current usage percentage and next reset timestamp for a Pro/Max subscription.
Describe alternatives you've considered
- Community tools like
ccusageparse local session logs to estimate token usage, but this is only an approximation and doesn't reflect the actual account-level weekly quota tracked by Anthropic. - Manually checking the claude.ai website works but can't be automated.
Use case
I'd like to set up a scheduled job that checks my real remaining weekly quota and sends me a notification (e.g. via a chat bot) so I can pace my usage across the week without having to remember to check the website manually.
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗