Skip to content
Skills Library
Programming · Tool integration

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 ↗
Licence
MIT
Last repository change
05.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 05.11.2026, without references to retired models or APIs.

Licence

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

  1. Install
  2. Update
  3. Remove
  4. More than one account
  5. When something looks wrong
Original SKILL.md headings · 54 lines, 430 words
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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.