Claude Usage Checker OpenClaw Plugin & Skill | ClawHub
Looking to integrate Claude Usage Checker into your AI workflows? This free OpenClaw plugin from ClawHub helps you automate ai & llms tasks instantly, without having to write custom tools from scratch.
What this skill does
Check Claude Code / Claude Max usage limits. Run when user asks about usage, limits, quota, or how much Claude capacity is left.
Install
ClawHub CLI
openclaw skills install @aligurelli/claude-usage-checkerNode.js (npx)
npx clawhub@latest install claude-usage-checkerFull SKILL.md
Open originalMetadata table.
| name | description | homepage |
|---|---|---|
| claude-usage | Check Claude Code / Claude Max usage limits. Run when user asks about usage, limits, quota, or how much Claude capacity is left. | https://github.com/aligurelli/clawd |
SKILL.md content below is scrollable.
Claude Usage Checker
Launches the Claude CLI interactively (PTY) and reads the /usage output to report your Claude Code / Claude Max quota.
Prerequisites
- Claude CLI must be installed (
npm i -g @anthropic-ai/claude-code) and logged in - If running
claudeshows "Missing API key", the user must log in manually first: open a terminal, runclaude, and complete the browser login flow - Requires an interactive PTY — the agent will launch a local process and read its output (quota info only)
Steps
- Launch
claudewith PTY - Wait for the welcome screen (poll until it appears)
- Send
/usage+ Enter - Read the output (poll until usage data appears)
- Close with Escape then
/exit - Report the results
Commands
# Launch claude with PTY
exec pty=true command="claude"
# Wait and check log
process action=poll sessionId=XXX timeout=5000
# Send /usage
process action=send-keys sessionId=XXX literal="/usage"
process action=send-keys sessionId=XXX keys=["Enter"]
# Read output
process action=poll sessionId=XXX timeout=5000
# Exit
process action=send-keys sessionId=XXX keys=["Escape"]
process action=send-keys sessionId=XXX literal="/exit"
process action=send-keys sessionId=XXX keys=["Enter"]
Notes
- If you see "Missing API key" → tell the user to log in; browser-based login won't work headlessly
- Allow a few seconds between polls — Claude CLI starts slowly
- "Current week" = weekly reset, not daily
Output Format
Report in a table:
| Usage | Resets | |
|---|---|---|
| Current session | X% used | today at HH:MM (timezone) |
| Weekly (all models) | X% used | HH:MM (timezone) |
| Weekly (Sonnet only) | X% used | HH:MM (timezone) |
| Extra usage | X% used / $X of $Y spent | date (timezone) |
Always show reset times. The CLI displays them as "Resets Xpm" — convert to HH:MM format.
ClawHub Registry URL: https://clawhub.ai/aligurelli/skills/claude-usage-checker