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.
Install
/plugin marketplace add connorchuang32/claude-usage-stats
/plugin install usage-stats@claude-usage-statsMods 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.
Details
- Repository
- connorchuang32/claude-usage-stats
- Folder
.- Marketplace
claude-usage-stats- Author
- Connor Chuang
- License
- MIT
- Last updated
- 25 October 2026
- Listed in
- awesome-claude-code-mods
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
5jonathanlocks/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).
usage-weather
5ptpmediabr/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.
squad-chat
5chrisluo5311/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.
vitals
5naicud/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.
session-pilot
5stgoddv/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.
wavy-usage
5BatuhanCakmakk/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.
Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.