Expose plan usage quota in statusLine JSON

Resolved 💬 3 comments Opened Feb 26, 2026 by niconistal Closed Apr 3, 2026

Feature Request

The statusLine JSON piped to custom scripts currently includes context_window.used_percentage (context window fill), but does not include the plan-level rate limit usage that Claude Max/Pro subscribers see in the UI ("Current session: X% used" with a reset timer).

Use case

I'm building a tmux status bar integration that shows Claude session info. The context window percentage is useful, but the number I actually care about is how much of my plan allocation I've consumed and when it resets — the same data shown in the Claude Code UI under usage.

Requested fields

Add to the statusLine JSON payload:

{
  "plan_usage": {
    "used_percentage": 39,
    "remaining_percentage": 61,
    "resets_at": "2025-02-26T00:00:00Z",
    "plan": "max"
  }
}

Current workaround

None — this data is only visible in the Claude Code UI and the account web page. There's no API endpoint, CLI flag, or other programmatic way to access it.

Environment

  • Claude Code v2.1.59
  • Claude Max subscriber
  • macOS

View original on GitHub ↗

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