Metadata-Version: 2.4
Name: claude-code-wrapped
Version: 0.1.3
Summary: Your year with Claude Code - Spotify Wrapped style terminal experience
Project-URL: Homepage, https://github.com/The-Money-Company-Limited/claudecodewrapped
Project-URL: Repository, https://github.com/The-Money-Company-Limited/claudecodewrapped
Author: Mert Deveci
License-Expression: MIT
License-File: LICENSE
Keywords: anthropic,claude,cli,stats,terminal,wrapped
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.12
Requires-Dist: rich>=13.0.0
Description-Content-Type: text/markdown

# 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

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

# Using npx
npx 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

```bash
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 2025         # View a specific year
```

## Requirements

- Python 3.12+ (with uvx, pipx, or pip)
- Or Node.js 16+ (for npx)
- 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](https://x.com/gm_mertd), Maker of [Banker.so](https://banker.so)

## License

MIT - see [LICENSE](LICENSE) for details.
