Feature Request: Expose Max/Pro plan usage limits for status line display

Open 💬 6 comments Opened Jan 31, 2026 by kalabar794

Problem

Claude Code's status line is customizable and can display session-level metrics (tokens, cost, context window %), but there's no way to access plan-level usage limits for Claude Max/Pro subscribers.

Currently, the only way to check how close you are to your usage limit is to:

  1. Open claude.ai
  2. Log in
  3. Navigate to Settings → Usage

This is disruptive when you're in a flow state working in the terminal.

Proposed Solution

Expose an endpoint or mechanism that returns current billing cycle usage for Max/Pro plans:

{
  "plan": "max_200",
  "billing_cycle": {
    "start": "2025-01-15",
    "end": "2025-02-14"
  },
  "usage": {
    "used_percentage": 67.5,
    "tokens_used": 12500000,
    "tokens_limit": 18500000
  }
}

This could be:

  • A new field in the status line JSON input
  • A CLI command like claude usage
  • An authenticated API endpoint

Use Case

Display usage in the status line with color-coded warnings:

[opus] 🟢 42% plan used | Session: .23 | Ctx: 15%
[opus] 🟡 78% plan used | Session: .23 | Ctx: 15%  
[opus] 🔴 94% plan used | Session: .23 | Ctx: 15%

Current Workaround

None for Max/Pro subscribers. The Admin API only works for organization accounts.

View original on GitHub ↗

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