token-reportlisted

# Token Report Read-only spend summary powered by `ccusage`. No new persistence — reads the same Claude Code usage logs that ccusage already tracks. ## Usage ``` /token-report # runs all three views: daily, session, blocks /token-report daily # today's totals by model /token-report session # per-session breakdown /token-report blocks # 5-hour billing-block view ``` ## Preflight Check Before running any view, verify ccusage is available and logs exist: ```bash npx -y ccusage@latest --version 2>/dev/null && echo "OK" || echo "MISSING" ``` If the check fails or output contains "No data", stop and report: > "ccusage is not installed or no Claude Code usage logs were found. Logs are written by the Claude Code desktop app to `~/.claude/logs/`. If you have run Claude Code sessions, ensure you are on the same machine and try again." ## Views Run the requested view(s). With no argument, run all three in order. ### Daily ```bash npx -y ccusage@latest daily --json 2>/dev/null ``` Report: - Date range covered - Total cost (USD) - Token breakdown: input / output / cache-read / cache-creation - Per-model cost and token row (sorted by cost desc) ### Session ```bash npx -y ccusage@latest session --json 2>/dev/null ``` Report: - Session count - Most expensive session (cost, model, task snippet if available) - Cumulative cost and tokens - Per-model breakdown across sessions ### Blocks ```bash npx -y ccusage@latest blocks --json 2>/dev/null ``` Report: -