VS Code Claude Usage banner
mhelbich mhelbich

VS Code Claude Usage

Development community

Description

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

Installation

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

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