Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

cc-wrapped

numman-ali1.2kMIT1.0.4

Generate a personalized Spotify Wrapped-style summary of your Claude Code usage

claude, claude-code, wrapped, cc-wrapped

readme

cc-wrapped

Your year in code, beautifully visualized.

Credit: Built on top of opencode-wrapped by moddi3 (@moddi3io).

Found this useful? Follow @nummanali for more AI tooling!

Generate a personalized "Spotify Wrapped"-style summary of your Claude Code usage.

License: MIT Bun

Claude Code Wrapped Example

Installation

Quick Start

Run directly without installing:

npx cc-wrapped # or bunx, or yarn/pnpm dlx

Global Install

npm install -g cc-wrapped # or bun/yarn/pnpm

Then run anywhere:

cc-wrapped

Usage Options

Option Description
--year, -y Generate wrapped for a specific year
--help, -h Show help message
--version, -v Show version number

Features

  • Sessions, messages, tokens, projects, and streaks
  • GitHub-style activity heatmap
  • Top models and providers breakdown
  • Usage cost (when available)
  • Shareable PNG image
  • Inline image display (Ghostty, Kitty, iTerm2, WezTerm, Konsole)
  • Auto-copy to clipboard

Terminal Support

The wrapped image displays natively in terminals that support inline images:

Terminal Protocol Status
Ghostty Kitty Graphics Full support
Kitty Kitty Graphics Full support
WezTerm Kitty + iTerm2 Full support
iTerm2 iTerm2 Inline Full support
Konsole Kitty Graphics Full support
Other terminals — Image saved to file only

Output

The tool generates:

  1. Terminal Summary — Quick stats overview in your terminal
  2. PNG Image — A beautiful, shareable wrapped card saved to your home directory
  3. Clipboard — Automatically copies the image to your clipboard

Data Source

Claude Code Wrapped reads data from your local Claude Code installation:

~/.claude/ (stats-cache.json, history.jsonl, transcripts)

No data is sent anywhere. Everything is processed locally.

Building

Development

# Run in development mode with hot reload
bun run dev

Production Build

# Build for all platforms
bun run build

Releasing

Releases are automated via semantic-release. Merging PRs with conventional commits to main triggers a release.

Tech Stack

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE for details.

Built for the Claude Code community

Credit: ccusage