Add rate limit utilization to status line JSON

[RossHepburn]

Feature request

Add plan usage / rate limit utilization data to the status line JSON input so custom status line scripts can display it.

Context

The status line command receives JSON on stdin with cost, context_window, model, and workspace data. However, there's no way to show plan usage limits (session % and weekly %) — the same data shown on https://claude.ai/settings/usage.

Claude Code already parses these values from API response headers internally:

• anthropic-ratelimit-unified-5h-utilization (session/5-hour usage %)
• anthropic-ratelimit-unified-7d-utilization (weekly usage %)

But they aren't passed through to the status line JSON.

Proposed addition

Add a rate_limit object to the status line JSON:

{
  "rate_limit": {
    "session": {
      "utilization": 30,
      "resets_at": 1773435600
    },
    "weekly": {
      "utilization": 75,
      "resets_at": 1773820800
    },
    "status": "allowed"
  }
}

Why

• The data already exists in memory (parsed from every API response header)
• Zero additional API calls needed — just pass through what's already there
• Enables users to build status lines that match the claude.ai usage page, with progress bars showing session and weekly limits
• Currently the only percentage available is context_window.used_percentage, which measures something completely different (conversation context, not plan usage)

Current workaround

None viable. The OAuth token can't be used against /v1/messages to get the headers directly, and /api/oauth/usage returns "OAuth authentication is currently not supported." The claude.ai usage page requires browser authentication, making it impractical to scrape.

[github-actions]

Found 3 possible duplicate issues:

1. Expose rate limit usage (session %, weekly %) to statusLine configuration #20636
2. [FEATURE] Expose rate-limit / plan quota usage in statusLine JSON input #27915
3. Feature request: expose rate limit utilization in statusline JSON #30784

This issue will be automatically closed as a duplicate in 3 days.

• If your issue is a duplicate, please close it and 👍 the existing issue instead
• To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

[kukushking]

Bumping this issue. Would be nice to see limits on custom status line.

[cellear]

Is "Bumping an issue" a thing? In that case, let me add my voice to those that would love to see this -- I've been wishing for this since I started heavily (for me -- I'm on the Pro plan) using Claude Code in November. Only recently have a realized that it wasn't a feature I didn't know how to find, but rather one that isn't possible.

I've thought about creating an agent that would just poll the terminal app, run /usage, and report the results back to me, but that seems like an awkward workaround for something that should just be in the app to begin with.

[Fyko]

This was released today! https://code.claude.com/docs/en/changelog#:~:text=Added%20rate_limits%20field%20to%20statusline%20scripts%20for%20displaying%20Claude.ai%20rate%20limit%20usage%20(5%2Dhour%20and%207%2Dday%20windows%20with%20used_percentage%20and%20resets_at)