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

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 🦞

S
Description
Hanzo Bot skill: claude-code-usage (by azaidi94)
Readme
37 KiB
Languages
Shell 100%