ccheatmap
v0.1.0
Published
Terminal-based GitHub-style contribution heatmap for Claude Code usage
Downloads
13
Maintainers
Readme
ccheatmap
Terminal-based GitHub-style contribution heatmap for Claude Code usage.
Quick Start
npx ccheatmapInstallation
npm install -g ccheatmapUsage
# Show last 2 months (default)
ccheatmap
# Show full year
ccheatmap --year
# Show different metrics
ccheatmap -m tokens
ccheatmap -m interactions
# Custom time range
ccheatmap -d 30
# Export as JSON
ccheatmap --json > data.jsonOptions
-m, --metric <type>:sessions,tokens, orinteractions(default:sessions)-d, --days <number>: Number of days to show (default:60)--year: Show full year (365 days)--no-legend: Hide intensity legend--no-stats: Hide statistics--no-months: Hide month labels--json: Output raw data as JSON
Requirements
- Node.js 18.0.0+
- Claude Code with usage history
Data Location
Automatically finds Claude Code data in:
~/.config/claude/projects/~/.claude/projects/- Custom path via
CLAUDE_CONFIG_DIR
Author
Vivek Nair ([email protected])
License
MIT
