mhelbich

VS Code Claude Usage — Development skill for Claude Code

Development community

A simple status bar & tooltip showing your Claude Code usage metrics.

How to install VS Code Claude Usage

This entry records only its repository, not the path inside it, so there is no exact command to give. Open mhelbich/VS-Code-Claude-Usage and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What VS Code Claude Usage does

A simple status bar & tooltip showing your Claude Code usage metrics.

Alternatives in Development

Tmux Claude Hatch — tmux plugin that runs Claude Code sessions in popups per project directory, with an fzf picker showing each se 381 ★
Opencode Bar — Effortless token usage tracker for OpenCode 309 ★
Cc Bar — Native macOS menu bar app: track quota, usage and cost for Codex (multi-account) and Claude Code, from your me 119 ★

README

Claude Code Usage Status - Extension for VS Code

Marketplace: [https://marketplace.visualstudio.com/items?itemName=mhelbich.claude-code-usage-status](https://marketplace.visualstudio.com/items?itemName=mhelbich.claude-code-usage-status)

A simple VS Code extension that shows your [Claude Code](https://claude.ai/code) session and weekly usage directly in the status bar — so you always know how much capacity you have left before hitting a limit.

_Tooltip_:

![Tooltip showing session and weekly remaining usage](assets/tooltip.png)

_Status bar_:

![Status bar showing session and weekly remaining usage](assets/status-bar.png)

Features

Status bar indicator — shows remaining usage for the current 5-hour session and the 7-day window, color-coded by how much is left
Rich tooltip — hover to see colored progress bars, exact remaining %, and both relative and absolute reset times
Usage History panel — a time-series chart in the bottom panel (alongside Terminal/Output) tracking the 5-hour session, general and model-specific 7-day limits, and extra credits. Filter by semantic windows like current session, current week, and today, or by fixed ranges like 1h, 6h, 1d, 7d, and 30d; the selected view persists across reloads. History is stored locally and retained for a configurable number of days.
History overlays — optional session-start markers, weekly reset markers, and weekly pace / forecast lines in the Usage History chart; each overlay can be toggled directly in the panel or via settings
Adaptive weekly forecast — a regularized baseline avoids noisy early-week extrapolation, then recent personal weekly patterns are incorporated with recency weighting. The shared projection appears in the history panel, tooltip, and a separate color-coded status bar dot; right-click the status bar and toggle "Claude Usage Forecast" to show or hide it
Customizable thresholds — configure when the indicator turns yellow or red
Auto-refresh — polls