A Bun terminal contribution chart for the usage data recorded in Claude Code session JSONL files. It renders a GitHub-style calendar with one square per day, colored by daily token activity.
npm install --global claude-streak
claude-streakclaude-streak requires Bun and reads the session files at ~/.claude/projects/ by default.
With Bun's package manager:
bun add --global claude-streakRun without installing:
bunx claude-streakclaude-streak --weeks 26
claude-streak --dir /path/to/claude/projects
claude-streak --today # show today's activity
claude-streak --models # show model breakdown
claude-streak --projects # show project breakdown
claude-streak --jsonFor local development from this checkout:
export PATH="$HOME/.bun/bin:$PATH"
bun link
claude-streak| Display | Source |
|---|---|
| Daily square | Assistant-message token totals for one local calendar day |
| Color intensity | Relative token usage across days with activity |
| Visible token total | Sum of token activity in the displayed week range |
| Current streak | Consecutive calendar days with assistant activity ending today |
| Longest streak | Longest consecutive run of calendar days with assistant activity |
Use --json to access the extended totals, including task, peak-token, duration, cost, and token-category values.
The CLI opens the session files read-only and does not modify Claude Code state.
MIT