claude-streak

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.

Install

npm install --global claude-streak
claude-streak

claude-streak requires Bun and reads the session files at ~/.claude/projects/ by default.

With Bun's package manager:

bun add --global claude-streak

Run without installing:

bunx claude-streak

Usage

claude-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 --json

For local development from this checkout:

export PATH="$HOME/.bun/bin:$PATH"
bun link
claude-streak

Metrics

| 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.

License

MIT