Claude Code doesn't warn you before it cuts off a session. You're mid-task, deep in context, and it stops. HowManyLeft puts a gauge on your deck so you can see the limit coming — and decide whether to keep going or save the big task for when the window resets. Run multiple accounts? Each key can independently track a different profile.
Five actions, one plugin
Session
Your 5-hour rolling usage window. How much have you burned this session.
Weekly
Your 7-day rolling window. Useful when pacing work across several days.
Overview
Both session and weekly side-by-side on a single key.
Status
Live Claude Code service status — green, degraded, or outage at a glance.
API Credits
Your Anthropic API spending this month. Set a budget to track remaining balance.
What it does
- Multiple accounts — connect personal, Teams, and Pro accounts independently. Each key shows whichever profile you choose from a per-key dropdown.
- Color stripe identification — add an optional colored bar (top or bottom) to instantly tell profiles apart without reading a label. Six colors to choose from.
- Four display modes — Gauge (arc), Bar (horizontal fill), Solid (full-key color), or Vertical bar (side column with large % readout). Switch per key from the Property Inspector.
- Color-coded gauge — orange means healthy, red means under 20% remaining. The color is the signal; you don't need to read a number.
- Shows remaining capacity — 100% means untouched. 0% means the window is fully consumed.
- No separate sign-in — reads credentials directly from the Claude Code CLI via macOS Keychain. Configure once from any key's Property Inspector.
- Tap to check usage — opens claude.ai/settings/usage in your browser.
- Hold to refresh — skips the wait and polls immediately.
- Isolated rate limiting — each profile has its own throttle and backoff. A rate limit on one account never slows down the others.
- API Credits tracker — connect an Anthropic Admin API key to see your monthly spend directly on a dedicated key. Optionally enter a budget to flip the display to remaining balance. Turns red below 20%.
Who it's for
Engineers running long Claude Code sessions
When you're deep in an agentic loop or a big refactor, knowing you're at 15% session remaining means you wrap up cleanly instead of having the context cut out at the worst moment.
Anyone batching AI-heavy work
Check the weekly gauge before kicking off something token-intensive. If you're at 8% weekly, you might want to pace it or wait for the window to reset.
People who've been surprised by the limit
The limit doesn't go away, but the surprise does. The gauge is always there; you stop thinking about it.
Teams and personal accounts side by side
Keep your work account on one key and your personal account on another. Each tracks its own quota independently — a rate limit on one never affects the other. Color stripes make them unmistakable at a glance.
Getting set up
- Install the Claude Code CLI and run
claudeonce in your terminal to sign in. - Install HowManyLeft from the Marketplace and drag whichever actions you want onto your keys.
- Open any key's Property Inspector → Connect to Claude Code. When macOS prompts for Keychain access, click Always Allow. All three actions share the same connection — configure once.
- Optional — multiple accounts: expand Add another account in any key's settings and follow the one-click Terminal flow to sign in with a second account. Once added, a dropdown lets each key independently track a different profile. Assign a color stripe to tell them apart.
- Optional — API Credits: drag the API Credits action onto a key, paste an Anthropic Admin API key (
sk-ant-admin-*) from console.anthropic.com → API Keys, and click Connect. Requires an organization account.
Good to know
Can I track multiple Claude accounts?
Yes. Open any key's settings, expand Add another account, and click Open Terminal to log in with a second account via the Claude Code CLI. Once it's added, click Scan for profiles to detect it. A dropdown then appears on each key so you can independently choose which account that key tracks. Add a color stripe to tell profiles apart at a glance.
Key shows "Setup needed"
Either the Claude Code CLI isn't installed, isn't signed in, or Keychain access was denied. Run claude in your terminal to confirm you're logged in. If Keychain keeps prompting, open Keychain Access, find Claude Code-credentials, and add Stream Deck to the list of allowed apps.
What does 0% mean?
Your session or weekly usage window is fully consumed. It resets on its normal schedule — 5 hours for session, rolling 7 days for weekly. Nothing to do but wait for the reset.
"Token expired"
Run claude in your terminal once to refresh the session, then click Connect to Claude Code again from the Property Inspector.
"Rate limited" or "Wait a moment"
Anthropic temporarily throttled the request. The plugin backs off automatically — first to 5 minutes, then to 30 minutes on repeated errors. It recovers on its own; no action needed.
API Credits: how do I connect?
Drag the API Credits action onto a key, open its Property Inspector, and paste an Anthropic Admin API key (starts with sk-ant-admin-). Create one at console.anthropic.com → API Keys. Click Connect. The key shows your spending for the current month. Hold the key for 600ms to force a refresh.
API Credits: shows "OK / key valid" but no dollar amount
You connected a regular API key (sk-ant-api03-*). Only Admin API keys (sk-ant-admin-*) can access spending data. Go to console.anthropic.com → API Keys, create an admin key, disconnect, and reconnect. Note: Admin keys are only available to organization accounts — individual accounts cannot create them.
API Credits: how does "remaining balance" work?
Anthropic doesn't expose a credit balance endpoint via API. The plugin shows spending instead. To see how much you have left, enter your total credits in the Budget field in the Property Inspector — the key then shows remaining = budget − spent and turns red when below 20%. Update the budget field whenever you top up.