mirror of
https://github.com/hanzoskill/claude-code-usage.git
synced 2026-10-30 21:13:43 +00:00
main
Claude Code Usage Skill
Check your Claude Code OAuth API usage limits directly from Bot.
Features
- π Session (5-hour) and Weekly (7-day) utilization tracking
- π¨ Beautiful progress bars with color-coded status indicators
- β‘ Smart caching (60s default) to avoid API spam
- π€ JSON output for scripting
- π¦ Telegram-friendly formatting
- π NEW v1.1.0: Automated monitoring with reset notifications
Quick Test
cd /Users/ali/bot/skills/claude-code-usage
./scripts/claude-usage.sh
Example Output
π¦ Claude Code Usage
β±οΈ Session (5h): π’ ββββββββββ 18%
Resets in: 2h 48m
π
Weekly (7d): π’ ββββββββββ 2%
Resets in: 6d 21h
Usage in Bot
Just ask:
- "How much Claude usage do I have left?"
- "Check my Claude Code limits"
- "What's my Claude quota?"
The skill automatically triggers and provides a formatted response.
Automated Monitoring (v1.2.0+)
Session Refresh Reminders (Recommended)
Get notified exactly when your 5-hour session quota refreshes!
One-command setup:
cd /Users/ali/bot/skills/claude-code-usage
./scripts/session-reminder.sh
This creates a self-scheduling chain that:
- Checks when your session refreshes
- Schedules the next reminder for that exact time
- Notifies you automatically every 5 hours
- Runs forever with zero maintenance
Reset Detection (Alternative)
Alternatively, monitor for quota resets by polling:
./scripts/monitor-usage.sh # Test once
./scripts/setup-monitoring.sh # Setup automated polling
See SKILL.md for detailed comparison and configuration options.
Publishing to Skills
To share with the community:
cd /Users/ali/bot/skills
skills publish claude-code-usage \
--slug claude-code-usage \
--name "Claude Code Usage" \
--version 1.0.0 \
--changelog "Initial release: Session & weekly usage tracking with beautiful formatting"
Author
Created for Bot by RZA π¦
Languages
Shell
100%