- New skills: clawddocs, claude-code-usage, summarize, homeassistant, humanizer, self-improving-agent - Add .learnings/ for self-improvement tracking - Document proaktive cron config (LRN-20260126-001) - Update USER.md: Löchgau as former residence - Update TOOLS.md: Peekaboo workaround - Memory files for 2026-01-25 and 2026-01-26
2.0 KiB
2.0 KiB
Claude Code Usage Skill
Check your Claude Code OAuth API usage limits directly from Clawdbot.
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/clawd/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 Clawdbot
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/clawd/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 ClawdHub
To share with the community:
cd /Users/ali/clawd/skills
clawdhub 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 Clawdbot by RZA 🦞