Files
James 36eb4a7b3b Add skills, learnings & memory updates (2026-01-26)
- 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
2026-01-26 09:26:26 +01:00

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+)

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 🦞