https://github.com/buildingopen/claude-code-stats
Spotify Wrapped for Claude Code. Visualize your AI coding stats, token usage, and costs.
https://github.com/buildingopen/claude-code-stats
ai-coding analytics claude claude-code cli cost-tracking developer-tools spotify-wrapped token-usage
Last synced: 1 day ago
JSON representation
Spotify Wrapped for Claude Code. Visualize your AI coding stats, token usage, and costs.
- Host: GitHub
- URL: https://github.com/buildingopen/claude-code-stats
- Owner: buildingopen
- License: mit
- Created: 2026-03-19T22:08:35.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-03-20T15:55:03.000Z (about 1 month ago)
- Last Synced: 2026-03-21T01:39:10.277Z (about 1 month ago)
- Topics: ai-coding, analytics, claude, claude-code, cli, cost-tracking, developer-tools, spotify-wrapped, token-usage
- Language: Python
- Size: 259 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Claude Recap
Operational stats dashboard for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). Pure numbers, terminal output.
## Quick Start
```bash
npx claude-recap
```
Requires Python 3.8+ and Node.js 14+.
## What You Get
```
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CLAUDE RECAP Mar 1 - Mar 20
20 days
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
OVERVIEW
Sessions 482 Active Days 18/20
Total Hours 187.0h Projects 12
Avg Session 23 min Messages 14,291
COST & ROI
API Value $1,247.83
Plan Cost $200.00 (Max)
ROI 6.2x
MODELS / TOKENS / PROJECTS / ACTIVITY / ERRORS / TREND
```
## Options
```bash
npx claude-recap # Full dashboard, all time
npx claude-recap --days 7 # Last 7 days only
npx claude-recap --days 30 # Last 30 days
npx claude-recap --project "OpenChat V4" # Filter to one project
npx claude-recap --plan pro # ROI calc with $20/mo
npx claude-recap --json # Machine-readable JSON
npx claude-recap --no-color # No ANSI colors (CI/piping)
npx claude-recap --help
```
## Plans for ROI
| Flag | Monthly Cost | Plan |
|------|-------------|------|
| `--plan pro` | $20 | Pro |
| `--plan max5` | $100 | Max 5x |
| `--plan max` | $200 | Max 20x (default) |
## Custom Data Directory
By default, sessions are read from `~/.claude/projects/`. Override with:
```bash
CLAUDE_PROJECTS_DIR=/path/to/projects npx claude-recap
```
Multiple directories (colon-separated):
```bash
CLAUDE_PROJECTS_DIR=/path/one:/path/two npx claude-recap
```
## JSON Output
```bash
npx claude-recap --json | python3 -m json.tool
npx claude-recap --json --days 7 > stats.json
```
## How It Works
Reads Claude Code JSONL session transcripts locally. Extracts token usage, timestamps, error patterns, and model info. Computes costs using published API pricing. All processing is local, no data leaves your machine.
## License
MIT