[FEATURE] Feature Request: Expose usage limits and quota data in statusLine stdin 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
Currently, the statusLine command receives a well-structured stdin JSON with session and context window info, but there is no field exposing account-level usage limits (e.g. rate
limits, weekly limits for Max plan users).
Current statusLine stdin JSON (relevant fields)
{
"context_window": {
"used_percentage": 12,
"total_input_tokens": 42000,
"total_output_tokens": 8000
}
// no rate_limit, quota, or weekly_limit fields
}
Requested addition
Please expose quota/limit data in the stdin JSON, for example:
{
"rate_limit": {
"requests_limit": 1000,
"requests_remaining": 850,
"requests_reset_at": "2026-03-17T00:00:00Z",
"tokens_limit": 10000000,
"tokens_remaining": 7500000
},
"weekly_limit": {
"used": 3200000,
"total": 10000000,
"reset_at": "2026-03-22T00:00:00Z"
}
}
Proposed Solution
Power users who customize their terminal statusLine want to see real-time quota usage at a glance — similar to how context_window.used_percentage is already surfaced. This is
especially useful for Max plan users who have weekly token limits.
Notes
- Anthropic already returns rate limit data via HTTP response headers (anthropic-ratelimit-*), so the data exists server-side
- This data should only be included when available and non-empty, to avoid breaking existing statusLine scripts
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 7 comments on GitHub. Read the full discussion on GitHub ↗