Usage Tracker
When to Use This Skill
✅ Use when:
- Need to track tool/resource usage over time
- Generating usage reports (daily, weekly, monthly)
- Monitoring quotas or limits
- Analyzing usage patterns
- Building dashboards
❌ Avoid when:
- Real-time metrics (use proper monitoring tools)
- High-frequency events (>100/second)
- Sensitive data without encryption
Summary
$(generate_summary "$period" | sed 's/\x1b[[0-9;]*m//g')
Daily Breakdown
| Date | Opus | Sonnet | Haiku | Total |
|---|---|---|---|---|
| EOF |
for i in $(seq 6 -1 0); do
local date=$(date -d "$i days ago" +%Y-%m-%d)
local opus=$(grep "$date" "$USAGE_LOG" | grep "|opus|" | wc -l)
local sonnet=$(grep "$date" "$USAGE_LOG" | grep "|sonnet|" | wc -l)
local haiku=$(grep "$date" "$USAGE_LOG" | grep "|haiku|" | wc -l)
local total=$((opus + sonnet + haiku))
echo "| $date | $opus | $sonnet | $haiku | $total |" >> "$output"
done
cat >> "$output" << EOFRecommendations
Based on current usage patterns: $(generate_recommendations)
Generated: $(date) EOF
echo "Report generated: $output"}
## Complete Example: Usage Monitor CLI
#!/bin/bash
ABOUTME: Complete usage monitoring CLI tool
ABOUTME: Track, analyze, and report on usage metrics
set -e
─────────────────────────────────────────────────────────────────
Configuration
─────────────────────────────────────────────────────────────────
SCRIPT_NAME="usage-monitor" USAGE_DIR="${HOME}/.${SCRIPT_NAME}" USAGE_LOG="$USAGE_DIR/usage.log"
Colors
RED='\033[0;31m' GREEN='\033[0;32m' YELLOW='\033[1;33m' BLUE='\033[0;34m' CYAN='\033[0;36m' NC='\033[0m'
─────────────────────────────────────────────────────────────────
Core Functions
*See sub-skills for full details.*
Resources
Version History
- 1.0.0 (2026-01-14): Initial release - extracted from workspace-hub check_claude_usage.sh
Sub-Skills