← Back to Skills Marketplace
1105
Downloads
0
Stars
4
Active Installs
4
Versions
Install in OpenClaw
/install claude-usage-checker
Description
Check Claude Code / Claude Max usage limits. Run when user asks about usage, limits, quota, or how much Claude capacity is left.
README (SKILL.md)
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.
Usage Guidance
This skill appears to do exactly what it says: run your local Claude CLI in a terminal and read the /usage output. Before installing or using it, confirm you have the official claude CLI installed and are comfortable letting the agent spawn an interactive terminal on your machine — whatever the CLI prints to the terminal can be read by the skill. Manually log in to claude first (the skill notes browser login won't work headlessly). If you are concerned about accidental disclosure, run the skill in a sandboxed environment (container or VM) or review the CLI behavior so you know what output it emits.
Capability Analysis
Type: OpenClaw Skill
Name: claude-usage-checker
Version: 1.3.0
The skill is classified as suspicious due to the use of `pty: true` in `SKILL.md` which grants broad interactive process control. While the explicit instructions for the agent are limited to running the `claude` CLI and sending benign commands (`/usage`, `/exit`), the `pty=true` capability itself is a high-risk permission. It creates a significant attack surface, as it allows for arbitrary command execution within the pseudo-terminal if the agent were compromised or if the `claude` binary itself had shell escape vulnerabilities, even though no malicious intent is present in the current instructions.
Capability Assessment
Purpose & Capability
Name and description match the runtime instructions: the skill needs the local 'claude' CLI and an interactive PTY to query /usage. Requiring the claude binary is appropriate for this purpose.
Instruction Scope
Instructions are narrowly scoped to launching the local claude CLI, sending the '/usage' command, reading output, and exiting. Minor caution: because it runs an interactive PTY and reads the process output, it could capture any text the CLI emits (including any unexpected sensitive lines). The instructions themselves do not ask for unrelated files, env vars, or external endpoints.
Install Mechanism
This is an instruction-only skill with no install spec and no code to download or execute. That minimizes supply-chain risk.
Credentials
The skill declares no environment variables, credentials, or config paths. That is proportionate to its stated goal of interacting with the local 'claude' CLI.
Persistence & Privilege
always is false and the skill does not request elevated or persistent system privileges or modify other skills. Autonomous invocation is permitted (platform default) but not combined with other red flags.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install claude-usage-checker - After installation, invoke the skill by name or use
/claude-usage-checker - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.3.0
Removed auto-install: claude CLI is a prerequisite, not auto-installed.
v1.2.0
Added binary requirements metadata (claude CLI + PTY), homepage link, and clearer prerequisite warnings.
v1.1.0
Translated instructions to English.
v1.0.0
Initial release: check Claude Code / Claude Max usage limits via PTY.
Metadata
Frequently Asked Questions
What is Claude Usage Checker?
Check Claude Code / Claude Max usage limits. Run when user asks about usage, limits, quota, or how much Claude capacity is left. It is an AI Agent Skill for Claude Code / OpenClaw, with 1105 downloads so far.
How do I install Claude Usage Checker?
Run "/install claude-usage-checker" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Claude Usage Checker free?
Yes, Claude Usage Checker is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Claude Usage Checker support?
Claude Usage Checker is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Claude Usage Checker?
It is built and maintained by kokoko (@aligurelli); the current version is v1.3.0.
More Skills