Feature: CLI command to check subscription usage

[vpatelsite]

Summary

Add a claude usage CLI command (or enhance /cost) that shows subscription usage stats — the same data visible at https://claude.ai/settings/usage — directly in the terminal.

Motivation

Currently, the only way to check how much of your weekly quota you've used is to open the browser and navigate to the settings page. For users who spend most of their time in the terminal with Claude Code, this is a friction point. Knowing remaining usage helps with planning — e.g., whether to tackle a big task now or wait for the quota reset.

Proposed solution

1. Expose a subscription usage API endpoint (e.g., GET /v1/usage/subscription) that returns current period usage, limits, and reset time
2. Add a CLI command (claude usage or similar) that calls this endpoint and displays a formatted summary, e.g.:

Claude Max — Weekly Usage
Messages:  342 / 500  (68%)
Reset:     2026-03-28 (3 days)

Alternatives considered

• /cost exists but only shows session-level token counts, not subscription quota
• Scraping the web UI is fragile and requires browser session auth
• No documented API currently exists for subscription usage data

Additional context

This would also benefit automation — users could set up alerts when approaching their limit, or integrate usage tracking into their workflows.

[github-actions]

Found 3 possible duplicate issues:

1. Feature request: Usage/billing API for Max plan users #38638
2. [FEATURE] add /usage command to Claude code #38593
3. Feature request: command to show Pro plan usage percentage and daily/monthly limit #33364

This issue will be automatically closed as a duplicate in 3 days.

• If your issue is a duplicate, please close it and 👍 the existing issue instead
• To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

[petmav]

I'm pretty sure this is already in CC as /usage? Might need to update your CC version.

[github-actions]

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.