Token Economics — Usage Analysis & Optimization

Analyze Claude Code session logs to measure token efficiency across six dimensions: cost, cache efficiency, conversation sprawl, model selection, output efficiency, and session patterns. Produces a scored report with risks, opportunities, and actionable recommendations.

Workflow

Step 1: Determine scope

From the user's request, determine:

• Project scope (default): analyze the current working directory's sessions
• Global scope: if the user says "all projects", "everything", "all repos", or "overall"

Also determine the time window:

• Default: 30 days
• Override if the user specifies a different period (e.g., "last week" → 7, "last 3 months" → 90)