[FEATURE] Feature Request: Expose usage limits and quota data in statusLine stdin JSON

Resolved 💬 7 comments Opened Mar 16, 2026 by dos2002 Closed Apr 16, 2026

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_

View original on GitHub ↗

This issue has 7 comments on GitHub. Read the full discussion on GitHub ↗