[FEATURE] Usage API for subscription plans (Pro/Max) to enable external dashboard integration

Preflight Checklist

• [x] I have searched existing requests and this feature hasn't been requested yet
• [x] This is a single feature request (not multiple features)

Problem Statement

Currently, Claude Code displays token usage (Current Session / Weekly limits) in the UI, but there is no API or programmatic way to retrieve this data for claude.ai subscription plans.

Many users run home servers or personal dashboards and would like to monitor their Claude usage alongside other metrics (CPU, memory, etc.).

Proposed Solution

Please provide a simple read-only API endpoint (e.g. with an API key or session token) that returns:

• Current session token usage
• Weekly token usage
• Plan limits

This would allow users to integrate their usage data into personal dashboards and avoid hitting limits unexpectedly.

Thank you for considering this request!

Alternative Solutions

_No response_

Priority

Critical - Blocking my work

Feature Category

CLI commands and flags

Use Case Example

_No response_

Additional Context

_No response_