Claude Code mod
ccusage
Reports Claude Code subscription rate limits to the CCUsage app over a local Unix socket and writes them to the app's log.
Install
git clone https://github.com/yuemingruoan/CCUsage.git
claude --plugin-dir ./CCUsage/packages/mod/pluginThe repo has no marketplace file, so load the plugin folder directly with --plugin-dir.
What it can access
- Reach
- L3Network: network, runs processes, reads files, reads env vars, reads settings, draws
- Hooks
session.startsession.measuresession.end
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
- yuemingruoan/CCUsage
- Folder
packages/mod/plugin- Author
- CCUsage
- License
- MIT
- Last updated
- 19 October 2026
- Listed in
- awesome-claude-code-mods
FAQ
What is ccusage?
Reports Claude Code subscription rate limits to the CCUsage app over a local Unix socket and writes them to the app's log. It is a mod for Claude Code, from yuemingruoan/CCUsage on GitHub.
What can the ccusage mod access?
Its widest reach is "network" (network, runs processes, reads files, reads env vars, reads settings, draws). Like any mod, it runs with your permissions.
How do I install ccusage?
Clone yuemingruoan/CCUsage and start Claude Code with --plugin-dir pointing at the mod's folder (packages/mod/plugin).
More context & usage mods
ccsidebar
richard-parayno/ccsidebar
Toggle-able right sidebar for Claude Code: usage limits, context window, prompt-cache countdown, activity and touched files
chef-station
schalkneethling/claude-chef
A Chef Station sidebar of sections that open and close: plan limits, today's spend, the hourly trend, models and projects, thirteen weeks of activity, the context window, and every Claude Code session running on this machine.
ccmod-chronicle
m-aoki1348125/ccmod-chronicle
Sidebar that analyzes how you use Claude Code: live warnings, cost, tips, standup and CLAUDE.md improvements. English and Japanese.
choitree
choidevhi/choitree
Live pane for Claude Code: file tree, git status, where Claude is working, tokens and usage limits, scoped to the current project
cc-usage-hud
Bing2000me/cc-usage-hud
A chip bar above the prompt: cache hit rate, a prompt-cache countdown in color, rate limits, cost (session/day/week/month) and TPS, with hover cards.
chudarin-context-mod
schudarin/chudarin-context-mod
A Claude Code mod: a side panel that shows what fills your context window, what your plan limits look like, what each kind of action costs and what the session's subagents processed, with plain-language help for every item.
Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.