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:
- Open claude.ai
- Log in
- 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.
This issue has 6 comments on GitHub. Read the full discussion on GitHub ↗