[FEATURE] Expose daily usage quota in statusline JSON data

Resolved 💬 3 comments Opened Jan 8, 2026 by cbeauhilton Closed Jan 8, 2026

Summary

The /usage command shows valuable information about daily usage quota (percentage used, reset time), but this data is not available programmatically. It would be helpful to expose this in the statusline JSON data so users can display their usage quota in their custom status lines.

Current Behavior

  • /usage shows: "90% used, Resets 4pm (America/Chicago)"
  • Statusline JSON only includes context window usage (tokens in current conversation) and session cost
  • No way to programmatically query daily usage quota

Proposed Solution

Add usage quota fields to the statusline JSON data:

{
  "usage_quota": {
    "percent_used": 90,
    "reset_time": "2026-01-08T22:00:00Z",
    "reset_time_local": "4pm",
    "timezone": "America/Chicago"
  }
}

Alternatively (or additionally), support a CLI flag:

claude --usage  # outputs JSON with quota info

Use Case

Users who customize their statusline want to see their daily usage quota alongside context window usage. Currently this requires manually typing /usage to check.

Environment

  • Claude Code version: 2.0.76
  • Platform: Linux

View original on GitHub ↗

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