@narai/claude-usage-cli

Terminal dashboard for monitoring Claude Code usage across multiple accounts.

npm | GitHub

Install

npm install -g @narai/claude-usage-cli

Usage

claude-usage                # Live-refreshing dashboard
claude-usage config         # Interactive account management
claude-usage auth <name>    # Add OAuth account via browser flow
claude-usage admin <name> <key>  # Add admin API key account
claude-usage remove <name>  # Remove a saved account
claude-usage list           # List saved accounts

Options

| Flag | Description | |------|-------------| | -d, --days <number> | Admin API lookback period in days (default: 7) | | -i, --interval <seconds> | Refresh interval (default: 30) | | -e, --show-email | Show email instead of account name for OAuth | | -c, --compact | Compact single-line layout | | -f, --full | Full layout with progress bars | | -a, --anonymous | Replace account names with sequential numbers | | --no-color | Disable colored output | | -h, --help | Show help |

Dashboard

The full dashboard shows two sections:

• Subscription — OAuth accounts with session/weekly usage and Sonnet breakdown
• API — Admin API accounts with token counts, cost, and period

Compact mode (-c) outputs a flat list without headers or separators, suitable for embedding in status bars or scripts.

Full mode (-f) renders visual progress bars for each usage window per account, with per-model token breakdowns for API accounts.

Account Types

OAuth accounts authenticate via browser flow and show rate limit utilization (session, weekly, per-model).

Admin API accounts use an Anthropic admin API key and show token usage, estimated cost, and billing period.

License

MIT