Claude Wrapped
Your Claude Code year in review, Spotify-Wrapped style. One command turns your Claude Code history into a scroll-through story and a shareable card. It runs 100% on your machine.
npx claude-year-wrapped # reads ~/.claude/projects and opens your story
npx claude-year-wrapped --demo # preview with fake data
Requires Node 18 or newer. No install, no account, no API key.
If the page opens as code instead of a design, your computer opens .html files in a text editor. Open the file from the output path in Chrome, Edge or Safari instead.
What you get
- Totals: prompts, sessions, active days, hours with Claude, best streak
- Tokens moved, in "copies of War and Peace"
- Manners: how many times you said please, thanks, sorry, and swore
- Rhythm: peak hour, busiest day, night-owl score
- Year heatmap: a GitHub-style calendar of your active days
- Languages Claude wrote for you, top tools, most-edited file, favorite words
- Badges: 11 achievements, such as Marathoner, Night Owl and Polite Human
- A personality: Builder, Night Owl, Gentleman, Architect, Minimalist, Streaker or Pressure Cooker
- A 1080x1350 PNG card and a copy-paste caption
FAQ
What is Claude Wrapped?
A free, open-source command-line tool that summarizes your Claude Code usage for the year, like Spotify Wrapped does for music.
Where does it get my data?
From the transcript files Claude Code already saves on your computer in ~/.claude/projects. It reads them locally.
Is my data uploaded anywhere?
No. It makes no network calls and has zero dependencies. The share card and caption contain only totals, with no prompt text and no project names.
How do I see last year's stats?
Run npx claude-year-wrapped --year 2025.
Does it work with the Claude desktop app or claude.ai chats?
No. It reads Claude Code transcripts only.
Are the stats exact?
Prompt, session and token counts come straight from your transcripts. Words like "please" are matched by simple text rules, and "hours with Claude" is estimated from session start and end times.
Options
| Flag | What it does |
|---|
--year 2025 | Summarize a different year |
--dir <path> | Use another transcripts folder |
--out file.html | Choose the output file |
--json | Print raw stats instead of HTML |
--no-open | Do not open the browser |
--demo | Use fake data |
Develop
npm test
npm run demo
Issues and ideas welcome. MIT licensed.
Releasing (maintainers)
Bump version in package.json and push to main. GitHub Actions runs the tests, then publishes to npm automatically using npm trusted publishing. No tokens or 2FA codes needed.
