Expose plan usage quota in statusLine JSON
Feature Request
The statusLine JSON piped to custom scripts currently includes context_window.used_percentage (context window fill), but does not include the plan-level rate limit usage that Claude Max/Pro subscribers see in the UI ("Current session: X% used" with a reset timer).
Use case
I'm building a tmux status bar integration that shows Claude session info. The context window percentage is useful, but the number I actually care about is how much of my plan allocation I've consumed and when it resets — the same data shown in the Claude Code UI under usage.
Requested fields
Add to the statusLine JSON payload:
{
"plan_usage": {
"used_percentage": 39,
"remaining_percentage": 61,
"resets_at": "2025-02-26T00:00:00Z",
"plan": "max"
}
}
Current workaround
None — this data is only visible in the Claude Code UI and the account web page. There's no API endpoint, CLI flag, or other programmatic way to access it.
Environment
- Claude Code v2.1.59
- Claude Max subscriber
- macOS
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗