hayeah/aiquota
skills/aiquota/SKILL.md
Report remaining Claude Code and Codex quota (5h and 7d). Use when the user asks how much quota is left.
development
Updated Apr 21, 2026
$ install --global
skillsauthnpx skillsauth add hayeah/dotfiles aiquotaInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 21, 2026, 7:26 AM49.4s3 files scanned
SKILL.md
- name:
- aiquota
- description:
- Report remaining Claude Code and Codex quota (5h and 7d). Use when the user asks how much quota is left.
aiquota
CLI that reports remaining quota for Claude Code (subscription) and Codex (ChatGPT plan).
- Claude: hits
https://api.anthropic.com/api/oauth/usagewith the local Claude OAuth token.- On macOS, reads the
Claude Code-credentialskeychain entry first. - Falls back to legacy credential files such as
~/.claude/.credentials.json.
- On macOS, reads the
- Codex: reads
payload.rate_limitsfrom the newest entry of the latest rollout JSONL under~/.codex/sessions/.
Setup
cd {baseDir} && uv tool install -e .
No secrets needed — Claude uses the local OAuth credentials, Codex reads local rollout files.
Usage
aiquota # JSON, both providers
aiquota --pretty # one-line summary per provider
aiquota --only codex
aiquota --only claude
Output (JSON) shape:
{
"claude": { ... /api/oauth/usage body ... },
"codex": {
"plan_type": "plus",
"primary": { "used_percent": 12.0, "window_minutes": 300, "resets_at": 1776..., "resets_at_iso": "..." },
"secondary": { "used_percent": 38.0, "window_minutes": 10080, "resets_at": 1776..., "resets_at_iso": "..." },
"_source": "/Users/.../rollout-....jsonl"
}
}
Errors surface per-provider as {"error": "..."} instead of exiting non-zero, so one broken side doesn't hide the other.
When to Use
- "How much Claude/Codex quota do I have left?"
- Before a long session, to check the 5h and 7d caps.
- Scripted polling (feed the JSON into a statusline or alert).
Notes
- Codex quota only updates after a Codex API response lands in a rollout — it can lag a minute or two.
- Claude quota only populates after the first API response in a session; out-of-session,
/api/oauth/usageis the authoritative source.
Related Skills
hayeah/webui
tools
VerifiedTrustedCommunity
Web UI development — Vite+ toolchain setup and browser-based E2E testing workflow.
SKILL.mdUpdated Apr 24, 2026
hayeah/typescript
tools
VerifiedTrustedCommunity
Tooling and style guide for TypeScript projects.
SKILL.mdUpdated Apr 24, 2026
hayeah/tmuxcap
development
VerifiedTrustedCommunity
Capture tmux pane content and export as text, HTML, SVG, PNG, or JPG. Use when you need a screenshot or text dump of a tmux pane for sharing, feeding to AI, or archiving terminal state.
SKILL.mdUpdated Apr 24, 2026
hayeah/text-copyedit
testing
VerifiedTrustedCommunity
Copy-edit text. Fix grammar and/or tidy text into a concise listicle.
SKILL.mdUpdated Apr 24, 2026