ccusage

by CCUsage · ★ 0 · updated 19 Oct 2026

Status linevalidates

0

Reports Claude Code subscription rate limits to the CCUsage app over a local Unix socket and writes them to the app's log.

install ccusage

Install

git clone https://github.com/yuemingruoan/CCUsage
claude --plugin-dir ./CCUsage/packages/mod/plugin

Then run /reload-plugins or start a new session. Requires Claude Code 2.1.287+.

View source on GitHub

What it hooks into

From an automated scan with claude plugin validate, not a security review. Mods run with your permissions; read the code before installing.

Events
session.startsession.measuresession.end
API calls
$.clock.every$.clock.now$.env.get$.fs.read$.http.fetch$.process.run$.session.id$.session.usage$.settings.read$.ui.status
Reach
level 3 of 3 networkruns processesreads filesreads env varsreads settingsdraws

Origin

How it got here
Automated scan of public GitHub repos, via the CC0 dataset awesome-claude-code-mods (scan of ).
Repository
github.com/yuemingruoan/CCUsage
Path in repo
packages/mod/plugin
Source commit
1cc3718 the exact code the scan read
Author
CCUsage @yuemingruoan
License
MIT
First published
Last pushed
First listed here

Name and description come from the mod's own manifest. We link to the code; we don't host it, and it stays under its author's license.