Feature request: programmatic/scriptable way to check current Pro/Max weekly usage quota

Status Open
Maintainer reply None cached
Activity 1 comment · opened Aug 13, 2026

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 --json CLI flag that outputs the same data /usage shows, 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 ccusage parse 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.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗