CC Wrapped

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.

Installation

Quick Start

Run directly without installing:

Global Install

Then run anywhere:

Usage Options

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:

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:

No data is sent anywhere. Everything is processed locally.

Building

Development

Production Build

Releasing

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

Tech Stack

- Runtime: Bun
- Image Generation: Satori + Resvg
- CLI UI: @clack/prompts
- Font: IBM Plex Mono

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