setup-vscode
/setup-vscode
Install the usage meter's VS Code status bar item, which shows Claude plan usage (5-hour, weekly and per-model weekly windows such as Fable) at the bottom right of VS Code. Use when the person asks to set up, install, add, fix or remove the usage meter in VS Code (or Cursor), or wants their Claude usage or limits in the status bar.
- Author
- azoni ↗
- Repository
- claude-usage-meter ↗
- Licence
- MIT
- Last repository change
- 05.11.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 05.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Install the usage meter's VS Code status bar item, which shows Claude plan usage (5-hour, weekly and per-model weekly windows such as Fable) at the bottom right of VS Code. Use when the person asks to set up, install, add, fix or remove the usage meter in VS Code (or Cursor), or wants their Claude usage or limits in the status bar.
Original author description
Install the usage meter's VS Code status bar item, which shows Claude plan usage (5-hour, weekly and per-model weekly windows such as Fable) at the bottom right of VS Code. Use when the person asks to set up, install, add, fix or remove the usage meter in VS Code (or Cursor), or wants their Claude usage or limits in the status bar.
How it works
- Install
- Update
- Remove
- More than one account
- When something looks wrong
SKILL.md preview
---
name: setup-vscode
description: Install the usage meter's VS Code status bar item, which shows Claude plan usage (5-hour, weekly and per-model weekly windows such as Fable) at the bottom right of VS Code. Use when the person asks to set up, install, add, fix or remove the usage meter in VS Code (or Cursor), or wants their Claude usage or limits in the status bar.
---
# Set up the usage meter in VS Code
A small VS Code extension that ships with this plugin shows Claude plan usage in the status
bar, for example `5h 38% · Wk 91% · Fable 2%`, with a table of reset times on hover. It asks
Claude Code for the numbers (the request behind `/usage`) every 2 minutes while VS Code is
focused, and also picks up the reading the plugin saves after each reply in
`~/.claude/usage-meter/reading.json`. Clicking the item refreshes it.
## Install
1. The extension file is `../../vscode/usage-meter-statusbar.vsix` relative to this skill's
base directory. Resolve it to an absolute path and check it exists.
2. Find the editor's command-line tool. Try `code` on the PATH first. If it is missing:
- macOS: `/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code`
- Windows: `%LOCALAPPDATA%\Programs\Microsoft VS Code\bin\code.cmd`
- Linux: usually `/usr/bin/code` or `/snap/bin/code`
- Cursor: `cursor`, the same way
If the person uses more than one of these editors, ask which one.
3. Install: `<cli> --install-extension "<absolute path to the .vsix>" --force`
4. Confirm: `<cli> --list-extensions --show-versions` lists `azoni.usage-meter-statusbar`.
5. Tell the person the item appears at the bottom right within a few seconds of VS Code
loading the extension. If it does not show, they can run "Developer: Reload Window" from
the command palette.
## Update
The same steps install a newer extension over an older one. Claude Code shows a note at
startup when the installed extension is older than the copy this plugin ships. After
installing, the person reloads the window ("Developer: Reload Window") so the new version
runs.
## Remove
`<cli> --uninstall-extension azoni.usage-meter-statusbar`
## More than one account
Each folder in `~/.claude/usage-meter/accounts` is another account, named after the folder.
To add one, the person signs in once:
`CLAUDE_CONFIG_DIR=~/.claude/usage-meter/accounts/<name> claude auth login --email <email>`.
Have them check the sign-in page shows that account before authorizing, then confirm with
`CLAUDE_CONFIG_DIR=<same folder> claude auth status`. The status bar then shows each account's
highest window, with the reset time at 85% or more, and the full table for each on hover.
## When something looks wrong
- Check the Output panel's "Claude usage meter" channel first: it says why a refresh failed.
- No item at all: the numbers exist only for Claude subscription accounts (Pro, Max, Team,
Enterprise) signed in to Claude Code. The extension runs the `claude` program bundled with
the Claude VS Code extension, or `claude` on the PATH when that extension is missing.
- The hover says "As of ...": the extension couldn't refresh since then, and no Claude
session with the plugin has had a reply since then either.
Versions
The database has no other skills named setup-vscode.
Database snapshot: 13.11.2026 · package version 8a64fd400c11 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 90context-meter
Install, update or remove the claude-context-meter status line, which shows context-window usage with a green/yellow/red legend at the bottom of Claude Code, and optionally plan quota left (5-hour and weekly) and session cost. Use when the user asks to set up, install, update,… - 87install-meter
Add the terse context meter to the Claude Code status line. Use when the user asks to install, enable or show the context meter or percentage in the status line. - 100mdcp-token-meter
Show how much of the session's context and tokens have been used. Use when the user asks "token meter", "how much session is used", "context usage", "how many tokens", or wants a usage readout in the status line (Claude Code). - 100vscode-settings
Configure a project's .vscode/settings.json - 2-space indent, no symlink following, and a per-project title bar/status bar color. Use when setting up VS Code for a project or changing its window color. - 95usage-statusline
Install a Claude Code status line that shows the model, context fill as a coloured bar with tokens used, and on Pro/Max plans the 5-hour and 7-day usage with time until each limit resets. One install script copies it to a stable path and sets statusLine in… - 95show-usage-limits
Put the user's Claude usage limits in their status line — the 5-hour and weekly windows, how much is spent, and when each resets — so hitting a limit stops being a surprise. Use this whenever someone asks to see their usage, wants to monitor rate limits or context usage, says…