Automate the retrieval of your Claude Max subscription usage limits and reset times via the Claude Code CLI.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install openclaw-claude-usage
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install openclaw-claude-usage using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Claude Usage Checker?
The Claude Usage skill provides a programmatic way to interact with the Claude Code TUI to fetch real-time data on plan consumption. By leveraging the expect utility, it bypasses the interactive nature of the terminal interface to extract critical metrics about your current session and weekly quotas. This integration is a valuable addition to your suite of Openclaw Skills, ensuring you never hit unexpected rate limits during development.
It specifically targets the /usage command within Claude Code, which is traditionally only available through manual interaction. By automating this process, developers can maintain a clear view of their AI resource availability without leaving their primary terminal environment.
Claude Usage Checker Use Cases
- Checking remaining quota for Claude Max subscription during intensive coding sessions.
- Determining exactly when rate limits will reset for different model types.
- Verifying if extra usage is enabled or if the free usage buffer is still available.
- Automating usage reporting within a larger workflow of Openclaw Skills.
How Claude Usage Checker Works
- Initiates the Claude Code CLI environment using the expect automation tool.
- Simulates interactive keyboard input to trigger the /usage command within the TUI.
- Captures the visual output and strips ANSI escape codes to normalize the text data.
- Parses specific metrics including session percentage, weekly model usage, and scheduled reset times.
- Presents a cleaned summary of the usage status to the user.
Claude Usage Checker Setup
Ensure you have the expect utility installed on your system and that your Claude Code CLI is fully authenticated. This is a prerequisite for this particular entry in the Openclaw Skills collection.
# Install expect on macOS using Homebrew
brew install expect
# Verify Claude Code authentication status
claude auth status
Once installed, you can trigger the skill whenever you need to verify your subscription health.
Claude Usage Checker Data Schema & Taxonomy
The skill processes and returns a structured view of the following metrics extracted from the TUI:
| Metric | Description |
|---|---|
| Current session | Percentage of usage used in the active session and the immediate reset time. |
| Current week (all models) | Aggregate usage across all Claude models for the current billing week. |
| Current week (Sonnet only) | Specific usage tracking for the Claude 3.5 Sonnet model. |
| Extra usage | Status of paid or free usage buffers beyond the standard plan limits. |
Claude Usage Checker Advanced Features
- Automated TUI interaction using custom expect scripts for non-interactive environments.
- Smart fallback mechanisms that query local metadata in ~/.claude/stats-cache.json if the CLI is unavailable.
- Support for parsing complex ANSI-heavy terminal output into readable text.
- Multi-model tracking for fine-grained control over your Openclaw Skills resource consumption.
SKILL.md
Loading
Related Openclaw Skills
Incident Response
A structured, 7-phase incident response framework for diagnosing and fixing OpenClaw system regressions and configuration failures.
git-repo-to-book
A sophisticated multi-agent orchestration skill that automates the research, writing, and review of full-length technical books directly from code repositories.
DeepWiki MCP
Query any public GitHub repository to get AI-powered documentation and source code answers without needing an API key.
Bird Twitter Skill
A high-speed CLI wrapper for Twitter/X that enables developers and AI agents to interact with the platform using GraphQL APIs.
OpenClaw Use Case Catalog
A curated knowledge base and research tool for discovering, documenting, and sharing real-world automation scenarios powered by OpenClaw.
ROSE Container Tools
A streamlined environment for building and running ROSE-based source code analysis tools within a Docker container to ensure toolchain compatibility.
METADATA
Featured*
