← Back to Skills Marketplace
6101
Downloads
16
Stars
39
Active Installs
3
Versions
Install in OpenClaw
/install claude-code-usage
Description
Check Claude Code OAuth usage limits (session & weekly quotas). Use when user asks about Claude Code usage, remaining limits, rate limits, or how much Claude usage they have left. Includes automated session refresh reminders and reset detection monitoring.
Usage Guidance
Install only if you are comfortable with a local script reading your Claude Code OAuth credential to call Anthropic's usage API. Do not run or schedule monitor-and-notify.sh unless you first replace or remove the hard-coded Telegram target, and review any Clawdbot cron jobs created by the reminder or monitoring scripts so you can stop recurring checks and notifications.
Capability Analysis
Type: OpenClaw Skill
Name: claude-code-usage
Version: 1.2.0
The skill is designed to check Claude Code OAuth usage limits and provide automated monitoring. It accesses specific 'Claude Code-credentials' from the system keychain or secret-tool, which is a sensitive operation but necessary for its stated purpose. It queries the legitimate Anthropic API endpoint `api.anthropic.com/api/oauth/usage`. Automated monitoring and reminders are implemented by scheduling tasks using the `clawdbot cron add` command, which operates within the agent's controlled environment rather than directly modifying system crontabs. All actions are transparently aligned with the skill's description, and there is no evidence of data exfiltration to unauthorized endpoints, malicious execution, or prompt injection attempts against the agent.
Capability Assessment
Purpose & Capability
Checking Claude Code quota, reading the local Claude Code OAuth credential, and querying Anthropic's usage API fit the stated purpose, and monitoring is documented; however, scripts/monitor-and-notify.sh sends reset notification content to a hard-coded Telegram target, which is not user-scoped.
Instruction Scope
The docs disclose credential access, Anthropic API calls, caching, cron-style monitoring, and Telegram delivery in general, but they do not disclose the fixed Telegram recipient in monitor-and-notify.sh or clearly separate read-only checking from persistent notification setup.
Install Mechanism
There is no remote installer or obfuscated install flow, and static scan and VirusTotal were clean; the metadata declares curl but the scripts also depend on local credential stores, claude, and clawdbot for full functionality.
Credentials
Accessing Keychain or secret-tool is sensitive but proportionate for a local quota checker and is documented; external notification to a hard-coded Telegram ID is not proportionate to user-controlled monitoring.
Persistence & Privilege
The skill documents self-scheduling Clawdbot cron reminders and polling monitors, which are purpose-aligned but persistent; session-reminder.sh also removes and recreates jobs by matching the reminder name, and Telegram delivery persists until the user removes the scheduled job.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install claude-code-usage - After installation, invoke the skill by name or use
/claude-code-usage - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.0
Added session refresh reminder system: self-scheduling cron chain that notifies exactly when 5-hour quota resets. Minimal API calls, zero maintenance. Includes comparison docs for both reminder and polling methods.
v1.1.0
Added automated monitoring: Get notified when session/weekly quotas reset. Includes monitor-usage.sh script and setup helpers.
v1.0.0
Initial release: Check Claude Code OAuth usage limits with beautiful progress bars and status indicators
Metadata
Frequently Asked Questions
What is Claude Code Usage?
Check Claude Code OAuth usage limits (session & weekly quotas). Use when user asks about Claude Code usage, remaining limits, rate limits, or how much Claude usage they have left. Includes automated session refresh reminders and reset detection monitoring. It is an AI Agent Skill for Claude Code / OpenClaw, with 6101 downloads so far.
How do I install Claude Code Usage?
Run "/install claude-code-usage" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Claude Code Usage free?
Yes, Claude Code Usage is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Claude Code Usage support?
Claude Code Usage is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).
Who created Claude Code Usage?
It is built and maintained by azaidi94 (@azaidi94); the current version is v1.2.0.
More Skills