Surface and explore Claude Code usage analytics. All tools live in
~/.dotfiles/claude-code-shared/. Run commands, then present a tight summary,
not the raw dump.
Commands
Benchmark (scripts/usage/cc-usage-benchmark.py):
- Full report, both profiles:
python3 ~/.dotfiles/claude-code-shared/scripts/usage/cc-usage-benchmark.py - One profile: add
--profile officeor--profile personal - Weekly model trend (mix + est cost): append
--trend - Tier adherence (expected vs actual model per skill): append
--adherence - Per-skill wall-clock latency + parallelism shape: append
--latency(add--min-n 3to drop rare skills) - Median output tokens per skill per week (info only, never an alert): append
--tokens
Weekly report (scripts/usage/weekly-usage-report.sh):
- Regenerate now:
bash ~/.dotfiles/claude-code-shared/scripts/usage/weekly-usage-report.sh - Latest saved report: read the newest file in
~/.dotfiles/claude-code-shared/usage-reports/usage-*.txt - Auto-runs Mondays 9am via launchd (
com.ericlingren.cc-usage-report)
How to respond
- Read intent: quick snapshot, trend over time, tier adherence, a single
profile, or a deep dive. For an open "show my usage", run the full benchmark
plus
--trend. - Run the matching command(s).
- Summarize, do not paste the raw output. Lead with headline numbers (model mix, est cost, top request intents), then trend direction, then adherence gaps.
- Surface 1-3 actionable observations. Examples: "Opus share climbing week over week", "tldr-tech ran on opus but is tiered sonnet (drift)", "T3 default holding".
- Offer next actions: re-tier a skill, change the session model, or drill into a profile or week.
Re-tiering from the data
If the data suggests a skill or agent should move tiers:
- Edit
~/.dotfiles/claude-code-shared/resources/model-tiers.json(skills map for skills, agents map for agents). python3 ~/.dotfiles/claude-code-shared/scripts/registration/sync-model-tiers.py --apply- Full tiering docs:
~/.dotfiles/claude-code-shared/resources/model-tiers.md
Notes
- Cost is an estimate (list prices; subagent tokens are not folded in).
- Adherence is only meaningful for sessions after the tiering rollout (older runs used the session model).
- Profiles: office =
~/.cco, personal =~/.cch. Default scans both.
Read and execute ~/.dotfiles/claude-code-shared/resources/learning-capture.md.
This skill's slug is cc-usage-analytics.