Claude Code mod

usage-stats

Claude Code usage stats in the desktop app: a token heat map, usage history by model, an hour-of-day chart and a Spotify Wrapped style year-in-review card.

5 starsContext & usage mods Plugin marketplaceValidates on Claude Code 2.1.325 Source

Install

Inside Claude Code
/plugin marketplace add connorchuang32/claude-usage-stats
/plugin install usage-stats@claude-usage-stats

Mods install like plugins. Run /reload-plugins or start a new session to load it.

What it can access

Reach
L2Writes or runs: runs processes, writes files, reads files, reads env vars, reads mod state, draws
Draws in
Pane
Hooks
session.startcommand.runui.render

From a static scan of the mod's code by awesome-claude-code-mods. It shows what the code asks for, not a security review.

How Claude Code mods work

  • A mod is a plugin with a JavaScript or TypeScript module that runs inside Claude Code (version 2.1.287 or later). It can draw panes beside the transcript, a band above the prompt, buttons and toasts, restyle the spinner and tool rows, and watch or rewrite tool calls and prompts.
  • It installs like any plugin: add its marketplace with /plugin marketplace add owner/repo, then /plugin install name@marketplace.
  • Check what a mod can reach before installing: it runs with your permissions. Reach goes from drawing only, to reading files, to writing files or running processes, to the network. Run claude plugin validate on a clone to list its hooks and calls without running it.
  • Turn one off from the Installed tab in /plugin, or start Claude Code with --safe-mode to skip every customization for a session.
Claude Code docs

Details

Folder
.
Marketplace
claude-usage-stats
Author
Connor Chuang
License
MIT
Last updated
25 October 2026

FAQ

What is usage-stats?

Claude Code usage stats in the desktop app: a token heat map, usage history by model, an hour-of-day chart and a Spotify Wrapped style year-in-review card. It is a mod for Claude Code, from connorchuang32/claude-usage-stats on GitHub.

What can the usage-stats mod access?

Its widest reach is "writes or runs" (runs processes, writes files, reads files, reads env vars, reads mod state, draws). It draws in Pane. Like any mod, it runs with your permissions.

How do I install usage-stats?

Inside Claude Code (v2.1.287 or later), run /plugin marketplace add connorchuang32/claude-usage-stats and then /plugin install usage-stats@claude-usage-stats.

Is usage-stats popular?

connorchuang32/claude-usage-stats has 5 GitHub stars and 0 forks, and is included in 1 curated Claude Code list. It was last updated on 25 October 2026.

More context & usage mods

usage-band-mod

5

jonathanlocks/usage-band-mod

A one-line band above the prompt with model, cost and bars for context, the 5-hour session, the week and per-model limits, plus a native settings window on macOS (and a preview of one on Windows).

Context & usage mods/plugin install

usage-weather

5

ptpmediabr/usage-weather

One quiet line above the prompt: context, 5-hour and weekly usage, whether the prompt cache is warm, and a Clear & continue button.

Context & usage mods/plugin install

squad-chat

5

chrisluo5311/squad-chat

The all-in-one Claude Code plugin. Talk with your squad, share code, and keep live rooms (usage, git, weather, lo-fi and more) next to your session. Zero tokens, zero leaks to Claude.

Context & usage mods/plugin install

vitals

5

naicud/cc-vitals

A light, framed live dashboard above the prompt, in the terminal and in the desktop app: model and effort, context and account-wide plan-limit meters (5-hour, weekly, per model, usage credits), cost and burn rate, tokens and cache per turn and session, auto-compaction, live tools, background shells and every subagent with its model and effort, plus weekly and monthly usage and the account's plan limits by product. Two columns on wide terminals, sized to the rows it has, never scrolling. Requires ccusage (npm i -g ccusage) for the usage section. /vitals-low, /vitals-medium and /vitals-high set the detail level; /vitals pane full view, /vitals report usage report.

Context & usage mods/plugin install

session-pilot

5

stgoddv/session-pilot

Keeps a long-running Claude Code orchestrator within its context and subscription quota: status of context and quota, self-compaction with a handoff, subagent caps by quota tier, and graceful pauses with automatic resume.

Context & usage mods/plugin install

wavy-usage

5

BatuhanCakmakk/wavy-usage

Liquid-filled rings above the Claude Code prompt for the 5-hour and 7-day limit windows, context fill and prompt-cache lifetime, a fighter jet that shows the model's effort, and a pane of recent turns, their cost, their share of the 5-hour window and what filled it.

Context & usage mods/plugin install

Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.