
usage
Check your Claude Code and Codex quota from inside Claude Code.
- GitHub stars
- 349
Install
/plugin install usage@usageRun it inside Claude Code after adding the marketplace with /plugin marketplace add aqua5230/usage.
Contents
Discovered from sourceSkills 1
Quota snapshot from usage-cli status --json:
!${CLAUDE_PLUGIN_ROOT}/scripts/quota.sh
Report this snapshot to the user in their language, one short line per agent:
- Name the agent (
claude-code→ Claude Code,codex→ Codex) and itsmodel. - Give
five_hour.used_percentandseven_day.used_percent. Anullpercent means unknown; say so instead of guessing. - Turn each window's
resets_in_secondsinto "resets in Xh Ym" (or "Xd Yh" past a day). If it isnullor absent, say the reset time is unknown. - If
age_secondsis over 3600, say the numbers may be stale. For Claude Code, the built-in/usagecommand is the live source. - If an agent has
"available": false, say it has no local data.
If the snapshot says usage-cli is not found, tell the user to run uv tool install usage-cli, or install the menu bar app with brew install --cask aqua5230/usage/usage (https://github.com/aqua5230/usage).
Do not run any other command.
Sponsors
Details
- Marketplace
- aqua5230/usage
- Source
- plugin
- Category
- Community