Expose rate limit usage (session %, weekly %) to statusLine configuration

Resolved 💬 11 comments Opened Jan 24, 2026 by tejasgadhia Closed Apr 24, 2026

Feature Request

Problem

The /usage command shows valuable rate limit information:

  • Current session: X% used (5-hour billing window)
  • Current week (all models): X% used (weekly limit)

However, this data is not available to the statusLine configuration. The statusLine only receives context window tokens and cost data, not the rate limit percentages.

Use Case

I want to see my session and weekly usage percentages persistently in the status bar without having to repeatedly open /usage. This would help me:

  • Know when I'm approaching limits before hitting them
  • Better pace my usage throughout the day/week
  • Avoid interruptions from unexpected rate limit hits

Current Workaround

None that provides the exact same data. Tools like ccusage track 5-hour blocks from JSONL files but may not match the percentages shown in /usage.

Proposed Solution

Add rate limit data to the JSON structure passed to statusLine scripts:

{
  "rate_limits": {
    "session": {
      "used_percentage": 91,
      "resets_at": "2026-01-24T13:59:00-06:00"
    },
    "weekly": {
      "used_percentage": 81,
      "resets_at": "2026-01-29T08:59:00-06:00"
    }
  }
}

This would allow users to display rate limit info in their custom status lines.

Environment

  • macOS Terminal
  • Claude Code CLI

View original on GitHub ↗

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