Skip to content
Back to skills

Quota

ASecurity

Show how much of the Claude Code and Codex 5-hour and weekly quota is used and when each window resets.

  • 336 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added September 25, 2026
ai-agentsbashgit

Works with

  • claude code
  • cli

Security analysis

A100/100

Scanned September 25, 2026

npx -y skills add aqua5230/usage --skill quota --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Quota?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Quota
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/aqua5230-quota/badge)](https://www.skillsdirectory.com/skills/aqua5230-quota)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: quota
description: Show how much of the Claude Code and Codex 5-hour and weekly quota is used and when each window resets.
disable-model-invocation: true
allowed-tools: Bash(${CLAUDE_PLUGIN_ROOT}/scripts/quota.sh)
---

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 its `model`.
- Give `five_hour.used_percent` and `seven_day.used_percent`. A `null` percent means unknown; say so instead of guessing.
- Turn each window's `resets_in_seconds` into "resets in Xh Ym" (or "Xd Yh" past a day). If it is `null` or absent, say the reset time is unknown.
- If `age_seconds` is over 3600, say the numbers may be stale. For Claude Code, the built-in `/usage` command 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.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…