ccusage-to-graph

Display ccusage JSON output as terminal graphs with Claude Pro/Pro Max threshold indicators.

Features

- 📊 Bar chart and line chart visualization
- 🎨 Color-coded cost ranges (green/yellow/red)
- 📏 Pro and Pro Max threshold lines ($20 and $200)
- 👑 Crown emoji marks the highest cost day
- 🚀 Lightweight and fast using asciichart
- 📝 TypeScript implementation
- 🔄 Compatible with ccusage JSON output format

Installation

$3

No installation required! Just use with npx:
``bash
npx ccusage@latest --json | npx @koinunopochi/ccusage-to-graph@latest
`

$3

`bash
npm install -g @koinunopochi/ccusage-to-graph
`

$3

`bash
git clone https://github.com/koinunopochi/ccusage-to-graph.git
cd ccusage-to-graph
npm install
npm run build
`

Usage

$3

`bash

Bar chart (default)

npx ccusage@latest --json | npx @koinunopochi/ccusage-to-graph@latest

Line chart

npx ccusage@latest --json | npx @koinunopochi/ccusage-to-graph@latest --type line

Hide threshold lines

npx ccusage@latest --json | npx @koinunopochi/ccusage-to-graph@latest --no-threshold
`

$3

`bash

After installing globally

ccusage --json | ccusage-graph
`

$3

`bash

Using local build

cat test-data.json | node dist/bin/ccusage-graph.js
cat test-data-threshold.json | node dist/bin/ccusage-graph.js
`

Options

- -t, --type : Graph type (bar or line, default: bar)
- -p, --period : Time period to display (future feature)
- --no-threshold`: Hide Pro and Pro Max threshold lines

Color Coding

- 🟢 Green: Under $20 (Less than Pro plan)
- 🟡 Yellow: $20-$200 (Exceeds Pro plan)
- 🔴 Red: Over $200 (Exceeds Pro Max plan)

License

MIT License - see LICENSE file for details

Author

koinunopochi

Contributing

Issues and Pull Requests are welcome!

Links

- GitHub Repository
- npm Package
- ccusage