[FEATURE] Expose Claude Max plan usage quota in statusline JSON
Preflight Checklist
- [x] I have searched existing requests and this feature hasn't been requested yet
- [x] This is a single feature request (not multiple features)
Problem Statement
When using Claude Code with a Claude Max subscription, I have no way to monitor my plan's usage quota from within the terminal. The statusline feature allows customizing the status bar with session data, but the JSON schema provided to statusline commands only exposes context window percentage and session-level information — it does not include account-level Max plan consumption (e.g., messages or tokens used vs. the current billing period limit).
Proposed Solution
Add a usage quota field to the statusline JSON payload, e.g.:
"account": {
"plan": "max",
"usage_percentage": 42.5,
"usage_reset_at": "2026-06-01"
}
This would allow users to build status bar indicators (progress bars, color gradients, percentage labels) that surface Max plan consumption directly in the terminal alongside existing context window and model information.
Alternative Solutions
_No response_
Priority
Critical - Blocking my work
Feature Category
CLI commands and flags
Use Case Example
_No response_
Additional Context
_No response_
This issue has 4 comments on GitHub. Read the full discussion on GitHub ↗