claude-code-wrapped 0.1.1

Your year with Claude Code - Spotify Wrapped style terminal experience

Claude Code Wrapped

  ░█████╗░██╗░░░░░░█████╗░██╗░░░██╗██████╗░███████╗
  ██╔══██╗██║░░░░░██╔══██╗██║░░░██║██╔══██╗██╔════╝
  ██║░░╚═╝██║░░░░░███████║██║░░░██║██║░░██║█████╗░░
  ██║░░██╗██║░░░░░██╔══██║██║░░░██║██║░░██║██╔══╝░░
  ╚█████╔╝███████╗██║░░██║╚██████╔╝██████╔╝███████╗
  ░╚════╝░╚══════╝╚═╝░░╚═╝░╚═════╝░╚═════╝░╚══════╝

            C O D E   W R A P P E D   2025
                    by Banker.so

Your year with Claude Code, Spotify Wrapped style.

Installation

# Using uvx (recommended)
uvx claude-code-wrapped

# Or install via pip
pip install claude-code-wrapped
claude-code-wrapped

Press Enter to advance through your personalized stats.

What You'll See

Dramatic stat reveals - one at a time, like Spotify Wrapped:

• Total messages exchanged
• Coding sessions
• Tokens processed
• Your longest streak

GitHub-style contribution graph - see your coding patterns at a glance

Your coding personality - based on your habits:

• 🦉 Night Owl
• 🔥 Streak Master
• ⚡ Terminal Warrior
• 🎨 The Refactorer
• 🚀 Empire Builder
• 🌙 Weekend Warrior
• 🎯 Perfectionist
• 💻 Dedicated Dev

Fun facts & bloopers - like "You coded after midnight 47 times"

Movie-style credits - featuring your top tools, projects, and models

Options

claude-code-wrapped              # Full cinematic experience
claude-code-wrapped --no-animate # Skip to dashboard view
claude-code-wrapped --json       # Export stats as JSON
claude-code-wrapped 2024         # View a specific year

Requirements

• Python 3.12+
• Claude Code installed (~/.claude/ directory exists)

How It Works

Reads your local Claude Code conversation history from ~/.claude/projects/ and aggregates:

• Message counts and timestamps
• Token usage (input, output, cache)
• Tool usage (Bash, Read, Edit, etc.)
• Model preferences (Opus, Sonnet, Haiku)
• Project activity

All data stays local. Nothing is sent anywhere.

Privacy

This tool is completely local and privacy-focused:

• No network requests - All data is read from your local ~/.claude/ directory
• No data collection - Nothing is sent to any server
• No API keys needed - Works entirely offline
• No secrets exposed - Only aggregated stats are shown, not conversation content

Author

Built by Mert Deveci, Maker of Banker.so

License

MIT - see LICENSE for details.