Ccusage Report

Claude Code Usage Report

Uses bunx ccusage to report token consumption and costs from Claude Code sessions.

Workflow

1. Determine the period

Identify the period from the user's message:

2. Run ccusage

{ "tool": "exec", "command": "bunx ccusage <period> --no-color -z Europe/Paris -o desc" }

Add --breakdown if the user asks for per-model details.

Filtering by date range:

• Today only: --since $(date +%Y%m%d) --until $(date +%Y%m%d)
• Last 7 days: --since $(date -d '7 days ago' +%Y%m%d)
• Specific month: --since 20260201 --until 20260228

3. Format the output

📊 Claude Code Usage — <period>

Date/Period : <value>
Models      : <comma-separated list>
Input       : <n> tokens
Output      : <n> tokens
Cache read  : <n> tokens
Total       : <n> tokens
Cost        : $<amount> USD

For multi-row output (e.g. last 7 days), summarize totals and list each row briefly.

4. Deliver

• Chat: Send the formatted message directly
• Telegram (cron context): Reply with ONLY the formatted message in a code block — no extra commentary

5. Error handling

• If bunx ccusage fails → check if bun/bunx is installed, report the error
• If no data for the requested period → inform the user clearly ("No usage data found for this period")
• If the output is empty → suggest checking a broader date range

Examples