Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Tencent SkillHub Β· Developer Tools
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.
skill openclawclawhub Free
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.
β¬ 0 downloads β
0 stars Unverified but indexed
Install for OpenClaw
Quick setup
- Download the package from Yavira.
- Extract the archive and review SKILL.md first.
- Import or place the package into your OpenClaw setup.
Package facts
- Download mode
- Yavira redirect
- Package format
- ZIP package
- Source platform
- Tencent SkillHub
- What's included
- CRON_SETUP.md, README.md, SKILL.md, scripts/claude-usage.sh, scripts/monitor-and-notify.sh, scripts/monitor-usage.sh
Validation
- Use the Yavira download entry.
- Review SKILL.md after the package is downloaded.
- Confirm the extracted package contains the expected setup assets.
Install with your agent
Agent handoff
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
New install
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
Upgrade existing
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
Trust & source
Release facts
- Source
- Tencent SkillHub
- Verification
- Indexed source record
- Version
- 1.2.0
Provenance
- Publisher
- azaidi94
- Source page
- View original listing
- Canonical URL
- Open canonical page
Documentation
Claude Code Usage
Check your Claude Code OAuth API usage limits for both session (5-hour) and weekly (7-day) windows.
Quick Start
cd {baseDir} ./scripts/claude-usage.sh
Usage
# Default: show cached usage (if fresh) ./scripts/claude-usage.sh # Force refresh from API ./scripts/claude-usage.sh --fresh # JSON output ./scripts/claude-usage.sh --json # Custom cache TTL ./scripts/claude-usage.sh --cache-ttl 300
Output
Text format (default): π¦ Claude Code Usage β±οΈ Session (5h): π’ ββββββββββ 40% Resets in: 2h 15m π Weekly (7d): π‘ ββββββββββ 60% Resets in: 3d 8h JSON format (--json): { "session": { "utilization": 40, "resets_in": "2h 15m", "resets_at": "2026-01-19T22:15:00Z" }, "weekly": { "utilization": 60, "resets_in": "3d 8h", "resets_at": "2026-01-22T04:00:00Z" }, "cached_at": "2026-01-19T20:00:00Z" }
Features
π Session limit (5-hour window) - Short-term rate limit π Weekly limit (7-day window) - Long-term rate limit β‘ Smart caching - 60-second cache to avoid API spam π¨ Beautiful output - Progress bars, emojis, color-coded status π Force refresh - --fresh flag to bypass cache π€ JSON output - Machine-readable format π Automated monitoring - Get notified when quotas reset
Status Indicators
π’ Green - 0-50% usage (healthy) π‘ Yellow - 51-80% usage (moderate) π΄ Red - 81-100% usage (high/critical)
Requirements
macOS: Uses Keychain to access Claude Code credentials Linux: Uses secret-tool for credential storage Credentials: Must have Claude Code CLI authenticated
How It Works
Retrieves OAuth token from system keychain Queries api.anthropic.com/api/oauth/usage with OAuth bearer token Parses five_hour and seven_day utilization metrics Calculates time remaining until reset Formats output with progress bars and status indicators Caches result for 60 seconds (configurable)
Cache
Default cache: /tmp/claude-usage-cache (60s TTL) Override: CACHE_FILE=/tmp/my-cache CACHE_TTL=300 ./scripts/claude-usage.sh
Examples
Check usage before starting work: ./scripts/claude-usage.sh --fresh Integrate with statusline: usage=$(./scripts/claude-usage.sh | grep "Session" | awk '{print $NF}') echo "Session: $usage" Get JSON for monitoring: ./scripts/claude-usage.sh --json | jq '.session.utilization'
Session Refresh Reminders (Recommended)
Get notified exactly when your 5-hour session quota refreshes! Quick Setup: ./scripts/session-reminder.sh This creates a self-scheduling chain of cron jobs that: Checks your current session expiry time Schedules the next reminder for when your session refreshes Notifies you with current usage stats Auto-removes itself (the new cron takes over) What You'll Get: π Claude Code Session Status β±οΈ Current usage: 44% β° Next refresh: 2h 15m Your 5-hour quota will reset soon! π¦ β Next reminder scheduled for: Jan 22 at 01:22 AM How It Works: Each reminder runs claude-usage.sh to find the exact session reset time Schedules a one-time cron for that exact moment Repeats every 5 hours automatically Self-correcting if session times ever drift Benefits: β Accurate to the minute β No manual scheduling needed β Adapts to your actual usage patterns β Minimal API calls (only when needed)
Reset Detection Monitor (Alternative)
Get automatic notifications when your Claude Code quotas reset by polling usage. Quick Setup: # Test once ./scripts/monitor-usage.sh # Setup automated monitoring (runs every 30 minutes) ./scripts/setup-monitoring.sh Or add via Clawdbot directly: # Check every 30 minutes clawdbot cron add --cron "*/30 * * * *" \ --message "cd /Users/ali/clawd/skills/claude-code-usage && ./scripts/monitor-usage.sh" \ --name "Claude Code Usage Monitor" \ --session isolated --deliver --channel telegram What You'll Get: π Claude Code Session Reset! β±οΈ Your 5-hour quota has reset π Usage: 2% β° Next reset: 4h 58m Fresh usage available! π¦ How It Works: Monitors usage every 30 minutes (configurable) Detects resets when usage drops significantly (>10% or <5%) Sends notifications via Telegram when resets occur Tracks state in /tmp/claude-usage-state.json Customization: # Change check interval clawdbot cron add --cron "*/15 * * * *" ... # Every 15 minutes clawdbot cron add --cron "0 * * * *" ... # Every hour # Custom state file location STATE_FILE=/path/to/state.json ./scripts/monitor-usage.sh
Which Monitoring Method?
FeatureSession ReminderReset DetectionAccuracyβ Exact minute~30min windowAPI callsMinimalEvery checkNotification timingRight on resetUp to 30min delaySetupOne commandOne commandMaintenanceSelf-schedulingCron runs forever Recommendation: Use Session Reminder for precise, real-time notifications.
Troubleshooting
No credentials found: Ensure Claude Code CLI is installed and authenticated Run claude once to trigger OAuth flow API request failed: Check internet connection Verify OAuth token hasn't expired Try --fresh to force new request Linux users: Install libsecret for credential storage: # Debian/Ubuntu sudo apt install libsecret-tools # Fedora/RHEL sudo dnf install libsecret
Category context
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Source: Tencent SkillHub
Largest current source with strong distribution and engagement signals.
Package contents
Included in package
3 Docs3 Scripts
- SKILL.md
- CRON_SETUP.md
- README.md
- scripts/claude-usage.sh
- scripts/monitor-and-notify.sh
- scripts/monitor-usage.sh