ccusage-graph

A CLI tool to visualize ccusage JSON reports as terminal graphs.

Features

• Cost bar chart (daily / weekly / monthly)
• Token usage bar chart (daily / weekly / monthly)
• Cost breakdown by model
• Period summary (total cost, average, peak period, etc.)
• Auto-detects JSON format from top-level key (daily, weekly, monthly)

Requirements

• Node.js >= 18

Usage

Pipe from ccusage (recommended)

npx ccusage@latest --json | npx @einere/ccusage-graph
npx ccusage@latest weekly --json | npx @einere/ccusage-graph
npx ccusage@latest monthly --json | npx @einere/ccusage-graph

File argument

npx ccusage@latest --json > report.json
npx @einere/ccusage-graph report.json

Redirect

npx @einere/ccusage-graph < report.json

Input JSON Format

Uses the JSON format generated by ccusage as-is.

License

MIT