Expose session/weekly token usage quota in statusLine JSON input

Resolved 💬 3 comments Opened Mar 4, 2026 by cditlimei Closed Apr 3, 2026

Feature Request

Current Behavior

The statusLine command receives a JSON input with these fields:

  • context_window.used_percentage / remaining_percentage (per-conversation context window)
  • context_window.total_input_tokens / total_output_tokens
  • session_id, model, cwd, etc.

The /status command shows much richer quota information:

  • Current session usage % and reset time
  • Current week (all models) usage % and reset date
  • Current week (Sonnet only) usage % and reset date

But this quota data is not available in the statusLine JSON input.

Desired Behavior

Add session and weekly token quota fields to the statusLine JSON input, for example:

{
  "session_quota": {
    "used_percentage": 11,
    "remaining_percentage": 89,
    "resets_at": "2026-03-04T00:00:00+08:00"
  },
  "weekly_quota": {
    "all_models": {
      "used_percentage": 46,
      "remaining_percentage": 54,
      "resets_at": "2026-03-06T11:00:00+08:00"
    },
    "sonnet_only": {
      "used_percentage": 13,
      "remaining_percentage": 87,
      "resets_at": "2026-03-06T11:00:00+08:00"
    }
  }
}

Motivation

Users want to monitor their token budget in real-time via the status bar, just like they can with context window usage. Currently, users have to manually run /status to check quota, which interrupts workflow. Having this in the status line would enable:

  1. Real-time awareness of remaining weekly quota
  2. Better cost management (knowing when to switch to Sonnet)
  3. Parity between /status display and statusLine data

Environment

  • Claude Code version: latest
  • OS: macOS

View original on GitHub ↗

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