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.
Three actions, one connection
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.
What it does
- 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.
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.
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.
Good to know
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.