Add weekly usage and reset times to statusline JSON data

Resolved 💬 3 comments Opened Jan 28, 2026 by AspiringPolyglot Closed Feb 1, 2026

Feature Request

Currently, the statusline script receives JSON data that includes context window usage (context_window.used_percentage), but it does not include:

  1. Session usage percentage - the current session's quota usage
  2. Session reset time - when the current session quota resets
  3. Weekly usage percentage - visible in /status → Usage tab
  4. Weekly reset time - when the weekly quota resets

Use Case

Users who configure custom statuslines (via PowerShell, bash, etc.) want to display their quota usage at a glance without having to open the /status menu. This is especially useful for users on usage-limited plans who need to monitor their consumption.

Current Behavior

The statusline JSON includes:

{
  "context_window": {
    "used_percentage": 11,
    "remaining_percentage": 89
  }
}

Requested Behavior

Add usage quota information to the statusline JSON:

{
  "usage": {
    "session": {
      "percent_used": 15,
      "resets_at": "2025-01-28T18:00:00Z"
    },
    "weekly": {
      "percent_used": 42,
      "resets_at": "2025-02-03T00:00:00Z"
    }
  }
}

This would allow statusline scripts to display something like:

Opus 4.5 | MyProject | Context: 11% | Session Usage: 15% (resets 18:00:00) | Weekly Usage: 42% (resets Mon 00:00:00)

Thank you!

View original on GitHub ↗

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