🐶 Free · Open source · 100% local

Claude Wrapped

Your Claude Code year in review. One command turns your history into a story and a card worth sharing.

npx claude-year-wrapped

View on GitHubFAQ Claude Wrapped share card showing prompts, tokens, pleases and best streak

By Alpit Patel · Published · Updated · Version 0.1.6

What does Claude Wrapped show? 🎁

Claude Wrapped reads the transcripts Claude Code already keeps on your computer and turns a year of work into numbers you can share. Everything below is computed locally in a few seconds.

🗣️Prompts and streaksPrompts, sessions, active days, hours with Claude and your best streak.
📚TokensTokens moved, measured in copies of War and Peace.
🙏Your mannersHow many times you said please, thanks and sorry. And swore. 🤬
🔥Year heatmapA GitHub-style calendar of your active days, plus peak hour and busiest day.
🌍Languages and toolsLanguages Claude wrote for you, top tools, most-edited file and favorite words.
🏆11 badgesAchievements such as Marathoner, Night Owl and Polite Human.
🐶A personalityOne of 7: Good Boy Builder, Night Owl, Gentleman, Architect, Minimalist, Streaker or Pressure Cooker.
🖼️A share cardA 1080x1350 PNG card and a copy-paste caption, with totals only.

How do I make my Claude Code Wrapped? ⚡

  1. Open a terminal with Node 18 or newer. No install, account or API key.
  2. Run npx claude-year-wrapped. It reads ~/.claude/projects on your machine.
  3. Scroll your story in the browser tab that opens.
  4. Share the card: save the PNG and paste the caption on X or LinkedIn.

Want a preview first? Run npx claude-year-wrapped --demo to see the story with fake data.

Which options can I use? 🛠️

FlagWhat it does
--year 2025Summarize a different year
--dir <path>Use another transcripts folder
--out file.htmlChoose the output file
--jsonPrint raw stats instead of HTML
--no-openDo not open the browser
--demoUse fake data

Is Claude Wrapped private? 🔒

Yes. Claude Wrapped has zero dependencies and makes no network calls. The story and the share card are built on your computer, and the card holds only totals: no prompt text and no project names. The code is MIT licensed, so you can read every line on GitHub or install it from npm.

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.

How do I run Claude Wrapped?

Run npx claude-year-wrapped in your terminal. It needs Node 18 or newer and no account or API key.

Is my Claude Code data uploaded?

No. It reads transcripts stored on your computer and makes no network calls. The share card contains only totals, never prompt text or project names.

Where does Claude Wrapped get its data?

From the transcript files Claude Code saves locally in ~/.claude/projects. Use --dir to point it at another folder.

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.

Can I get the raw numbers?

Yes. Run npx claude-year-wrapped --json to print the stats as JSON instead of opening the story.