analyze-token-usage

What problem does it solve?

Helps you find where Claude Code is spending the most tokens by scanning local session logs and surfacing costly projects, sessions, and spawned subagents so you can prioritize optimizations and reduce billing and context bloat.

Core Features & Use Cases

• Startup analysis: Inspect the first assistant turn to measure startup context and estimate contributions from CLAUDE.md, AGENTS.md, skills, hooks, and memory.
• Historical analysis: Aggregate tokens across projects and sessions, filter by date, and rank the most expensive sessions and subagents.
• Reporting: Produce a human-readable markdown token_report and per-project prompt exports to support audits and cost breakdowns.
• Use case: Run this Skill to identify a single long-running session or a plugin that contributes disproportionately to token costs and decide whether to disable or silence it.

Quick Start

From your project directory run the analyze_startup.py or analyze_tokens.py script in the skill's scripts directory to generate a token report in your ~/.claude/token-analysis folder.