claude-code-usage
CommunityReal-time Claude Code quota and reset alerts
AuthorMagicWifiMoney
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Keeping track of Claude Code OAuth usage and resets manually is error-prone and time-consuming, which can lead to unexpected rate limits and interrupted workflows. This Skill consolidates session (5-hour) and weekly (7-day) utilization into readable output, helps avoid hitting quotas, and notifies you when quotas refresh.
Core Features & Use Cases
- Session & Weekly Tracking: Reports five-hour session and seven-day weekly utilization with color-coded progress bars.
- Smart Caching & Formats: Provides short TTL caching to avoid API spam and supports both human-readable and JSON output for automation.
- Automated Monitoring & Alerts: Detects resets via polling or schedules exact reminders using a self-scheduling cron chain and integrates with Clawdbot/Telegram for notifications.
- Use Case: Monitor Claude Code usage before heavy development sessions, automatically receive a Telegram alert when the 5-hour session resets, and feed JSON into dashboards or status lines.
Quick Start
Ask the agent to check my Claude Code session and weekly usage and notify me when quotas reset.
Dependency Matrix
Required Modules
curlclaudesecret-toolclawdbot
Components
scripts
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: claude-code-usage Download link: https://github.com/MagicWifiMoney/openclaw-starter-kit/archive/main.zip#claude-code-usage Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.