Feature request: command to show Pro plan usage percentage and daily/monthly limit

Resolved 💬 3 comments Opened Mar 11, 2026 by mauricio-pagarme Closed Apr 18, 2026

Problem

As an individual Claude Code Pro subscriber ($20/month plan), there is currently no way to know:

  • How much of my plan quota I've already used
  • What percentage of my limit I've reached
  • When my usage will be interrupted

The only feedback I get is an abrupt error after the limit is hit — with no warning beforehand. This is disruptive when I'm in the middle of a coding session.

Proposed Solution

Add a built-in command (e.g. /usage or /plan) that shows:

Plan: Pro ($20/month)
Usage today:  42% (used: ~$8.40 / $20.00)
Reset:        in 18 days

Or at minimum, expose this data so that hooks (e.g. Stop, PreToolUse) can access it programmatically and display warnings before the limit is reached.

Why this matters

  • Users get interrupted mid-task with no prior warning
  • There is no API endpoint for individual Pro subscribers to query remaining quota
  • The only option today is to manually check claude.ai → Settings → Usage in a browser
  • Hooks like Stop receive a JSON payload with session metadata, but token usage and plan quota are not included

Suggested implementation

  1. Expose a /usage or /plan slash command in the CLI
  2. Include plan quota info in the Stop hook JSON payload (e.g. plan_usage_pct, plan_remaining_usd)
  3. Optionally, add a configurable threshold warning (e.g. warn when 80% of plan is consumed)

This would be especially valuable for individual subscribers who cannot use the Admin API (only available for organizations).

---
Reported via Claude Code CLI

View original on GitHub ↗

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