[DOCS] Status line docs missing `rate_limits` field for Claude.ai usage windows

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/statusline

Section/Topic

"Available data" table and "Full JSON schema" example

Current Documentation

The "Available data" table lists all top-level fields passed to statusline scripts via stdin: session, model, account, system, currentCost, and tool. The full JSON schema accordion shows a complete example payload. Neither the table nor the schema include a rate_limits field.

No documentation currently exists for the rate_limits statusline field, its sub-fields (used_percentage, resets_at), or the 5-hour and 7-day usage windows it exposes.

What's Wrong or Missing?

Changelog v2.1.80 added a rate_limits field to statusline scripts for displaying Claude.ai rate limit usage (5-hour and 7-day windows with used_percentage and resets_at). This field is not documented in the statusline page's "Available data" table or the full JSON schema example.

Users writing custom statusline scripts have no way to discover this field exists, what structure it contains, or how to use it to display rate limit information.

Suggested Improvement

Add a rate_limits row to the "Available data" table:

| Field | Description |
|-------|-------------|
| rate_limits | Claude.ai rate limit usage for 5-hour and 7-day windows, including used_percentage and resets_at for each window |

Update the full JSON schema example to include the rate_limits object with its nested structure showing both usage windows and their sub-fields.

Note: This field may be null or absent for non-Claude.ai authentication methods (e.g., API key, Bedrock, Vertex). Document null-handling behavior if applicable.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Context |
|------|---------|
| https://code.claude.com/docs/en/statusline | "Available data" table and full JSON schema example |

Total scope: 1 page affected

Source: Changelog v2.1.80

Added rate_limits field to statusline scripts for displaying Claude.ai rate limit usage (5-hour and 7-day windows with used_percentage and resets_at)