ds_usage

Your Claude usage limits in the VS Code status bar, so you can see how close you are without opening the usage panel.

devshakib.jumyn.com · github.com/devShakib015

Claude 5h 12% · 7d 39% sits in the bottom bar. Hover for every limit and when each one resets; click to refresh. The item turns amber at 75% and red at 90%.

ds_usage

What it touches

Worth reading before you install it, because it uses your Claude Code login.

That login, read-only. The macOS Keychain entry Claude Code-credentials, or ~/.claude/.credentials.json elsewhere. The token is never refreshed, never written back, never logged, and goes nowhere except api.anthropic.com over HTTPS.
One request every few minutes, shared by all your VS Code windows.
Nothing else. No telemetry, no other network calls, nothing leaves your machine but that one request.

It needs Claude Code installed and signed in. Without that, the item says so and does nothing else.

Where the numbers come from

The same endpoint Claude Code's own usage panel reads, authorised with the login Claude Code already keeps — the macOS Keychain entry Claude Code-credentials, or ~/.claude/.credentials.json on other systems.

The extension only reads that login. It never refreshes the token or writes anything back, so it cannot sign Claude Code out. If the stored token has expired, the item says so; use Claude Code once and it renews itself.

The first time, macOS may ask whether to allow access to that Keychain entry.

A failed check is normal — Claude Code rewrites that entry when it renews its login. The extension keeps the last numbers on screen, retries after 20, 60 and 120 seconds, and only shows a warning after three failures in a row. The tooltip always names the last failure.

It asks rarely on purpose. The endpoint answers 429 if asked too often, so every VS Code window shares one result through a file in global storage — only the window that finds it stale fetches — and a 429 sets a wait (the server's own retry-after, or 5 minutes doubling to at most 30) that clicking cannot override. The tooltip shows when the next check is due.

This is not a published API. It is what Claude Code uses internally, so a Claude Code update could change or remove it, and this extension would then show a warning instead of numbers.

Settings

setting	default
`dsUsage.refreshMinutes`	`5`	how often to fetch
`dsUsage.showInBar`	`five_hour`, `seven_day`	which limits sit in the bar; every limit is in the tooltip
`dsUsage.warnAt`	`75`	amber from this percentage
`dsUsage.alertAt`	`90`	red from this percentage

By

devShakib — devshakib.jumyn.com · github.com/devShakib015

Licence

MIT.