usage-tracker

vamseeachanta

更新日 Today

18 閲覧

その他bashmetricslogginganalyticstrackingreporting

について

usage-trackerスキルは、タイムスタンプ付きのロギングとレポート機能を通じて、開発者がツールやリソースの使用状況を経時的に追跡・分析できるようにします。定期的な使用レポートの生成、クォータの監視、利用傾向の検出を目的として設計されていますが、リアルタイムまたは高頻度のイベント追跡には適していません。主な機能には、ダッシュボード構築のための日次／週次／月次単位の内訳やパターン分析が含まれます。

クイックインストール

Claude Code

推奨

メイン

npx skills add vamseeachanta/workspace-hub

プラグインコマンド代替

/plugin add https://github.com/vamseeachanta/workspace-hub

Git クローン代替

git clone https://github.com/vamseeachanta/workspace-hub.git ~/.claude/skills/usage-tracker

このコマンドをClaude Codeにコピー＆ペーストしてスキルをインストールします

ドキュメント

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" << EOF

Recommendations

Based on current usage patterns: $(generate_recommendations)

Generated: $(date) EOF

echo "Report generated: $output"

}


## Complete Example: Usage Monitor CLI

```bash
#!/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

- [awk One-Liners](https://catonmat.net/awk-one-liners-explained-part-one)
- [sed/awk Tutorial](https://www.grymoire.com/Unix/Awk.html)
- [Date Manipulation in Bash](https://www.cyberciti.biz/faq/linux-unix-formatting-dates-for-display/)

---

## Version History

- **1.0.0** (2026-01-14): Initial release - extracted from workspace-hub check_claude_usage.sh

## Sub-Skills

- [1. Basic Usage Logging (+1)](1-basic-usage-logging/SKILL.md)
- [3. Usage Summary Reports (+1)](3-usage-summary-reports/SKILL.md)
- [5. Trend Analysis (+1)](5-trend-analysis/SKILL.md)
- [Best Practices](best-practices/SKILL.md)

GitHub リポジトリ

vamseeachanta/workspace-hub

パス: .claude/skills/_core/bash/usage-tracker