{"_id":"@da-trollefsen/claude-wrapped","_rev":"6-a82aff47644d77d0dc97ff764bdcde51","name":"@da-trollefsen/claude-wrapped","dist-tags":{"latest":"1.0.6"},"versions":{"1.0.0":{"name":"@da-trollefsen/claude-wrapped","version":"1.0.0","keywords":["claude","anthropic","cli","wrapped","stats","terminal","claude-code","analytics","export","2025","2026","2027"],"author":{"name":"Daniel Tollefsen"},"license":"MIT","_id":"@da-trollefsen/claude-wrapped@1.0.0","maintainers":[{"name":"da-trollefsen","email":"daniel@trollefsen.com"}],"homepage":"https://github.com/da-troll/claude-wrapped#readme","bugs":{"url":"https://github.com/da-troll/claude-wrapped/issues"},"bin":{"claude-wrapped":"bin/cli.js","claude-code-wrapped":"bin/cli.js"},"dist":{"shasum":"9314625eaff07848163db2c71937c38e57e19f68","tarball":"https://registry.npmjs.org/@da-trollefsen/claude-wrapped/-/claude-wrapped-1.0.0.tgz","fileCount":19,"integrity":"sha512-jq31G3k2+krOLNQkKD4QAB+HZm0JIIbSdFvmMvz+PGdwtYkHCeRyQedjm0SIE+4ksybntj9NSs9GHugXC2gasQ==","signatures":[{"sig":"MEYCIQDNdjZ4fLuvruqZYn3I7yg5jgsmv+lKMxNfW5RALhjWPwIhAPVu1qQAAUvHG1mXeTsP2PmvVW0iLZol6uHGh2S53atR","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":163887},"engines":{"node":">=16.0.0"},"gitHead":"7ffb6fa7ffc1ea859a156cc0d9a7e4e0f43ee9a3","scripts":{"start":"node bin/cli.js"},"_npmUser":{"name":"da-trollefsen","email":"daniel@trollefsen.com"},"repository":{"url":"git+https://github.com/da-troll/claude-wrapped.git","type":"git"},"_npmVersion":"11.6.0","description":"Your year with Claude Code - Spotify Wrapped style terminal experience","directories":{},"_nodeVersion":"25.2.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/claude-wrapped_1.0.0_1767398368932_0.22471401599655705","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@da-trollefsen/claude-wrapped","version":"1.0.1","keywords":["claude","anthropic","cli","wrapped","stats","terminal","claude-code","analytics","export","2025","2026","2027"],"author":{"name":"Daniel Tollefsen"},"license":"MIT","_id":"@da-trollefsen/claude-wrapped@1.0.1","maintainers":[{"name":"da-trollefsen","email":"daniel@trollefsen.com"}],"homepage":"https://github.com/da-troll/claude-wrapped#readme","bugs":{"url":"https://github.com/da-troll/claude-wrapped/issues"},"bin":{"claude-wrapped":"bin/cli.js","claude-code-wrapped":"bin/cli.js"},"dist":{"shasum":"98e6b5bea01b18d12a4867199e7dbd71171396c6","tarball":"https://registry.npmjs.org/@da-trollefsen/claude-wrapped/-/claude-wrapped-1.0.1.tgz","fileCount":19,"integrity":"sha512-nf7QHOO73crl0zI4QdbESV7nTARG9s9wtYaGH89MTwLnYOpOA06FdES0pQRmY/oee0Vck6ym/6TTjdT9V7j7JQ==","signatures":[{"sig":"MEYCIQC0AHlFvA1J3KT8wALvFu6oGAnvmCSxro14YtTUlf+mMwIhAOlOvbwXaiAppSY8YCIFgQ1/m3/x1DoyWH1eevf8NHQf","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":163903},"engines":{"node":">=16.0.0"},"gitHead":"f6990ac4405610ddba340dedba4ee19623188d1a","scripts":{"start":"node bin/cli.js"},"_npmUser":{"name":"da-trollefsen","email":"daniel@trollefsen.com"},"repository":{"url":"git+https://github.com/da-troll/claude-wrapped.git","type":"git"},"_npmVersion":"11.6.0","description":"Your year with Claude Code - Spotify Wrapped style terminal experience","directories":{},"_nodeVersion":"25.2.1","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/claude-wrapped_1.0.1_1767398574334_0.04714768045503859","host":"s3://npm-registry-packages-npm-production"}},"1.0.6":{"name":"@da-trollefsen/claude-wrapped","version":"1.0.6","description":"Your history with Claude Code - a Spotify Wrapped style visual terminal experience.","bin":{"claude-wrapped":"bin/cli.js","claude-code-wrapped":"bin/cli.js"},"scripts":{"start":"node bin/cli.js"},"repository":{"type":"git","url":"git+https://github.com/da-troll/claude-wrapped.git"},"keywords":["claude","anthropic","cli","wrapped","stats","terminal","claude-code","analytics","export","2025","2026","2027"],"author":{"name":"Daniel Tollefsen"},"license":"MIT","bugs":{"url":"https://github.com/da-troll/claude-wrapped/issues"},"homepage":"https://github.com/da-troll/claude-wrapped#readme","engines":{"node":">=16.0.0"},"_id":"@da-trollefsen/claude-wrapped@1.0.6","gitHead":"2aec926c5c3ee4f1eb05d23895d7060262d3c2d9","_nodeVersion":"25.2.1","_npmVersion":"11.6.0","dist":{"integrity":"sha512-hiBXurGfTnoOej1X8oi6dZY0l+mf9R37Q7hkH7QKFhYlnHAgZAL6VwNe6OsyaGJUBI8ilZ1PnXFGkyrDinjH6Q==","shasum":"2ae83ddd1473ab1244065a418403dd4683f1f0d1","tarball":"https://registry.npmjs.org/@da-trollefsen/claude-wrapped/-/claude-wrapped-1.0.6.tgz","fileCount":19,"unpackedSize":167099,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDOyqW4W2lIY7cH7xdt5EyfoKhd6v606EyQ85iRayepOwIhAM/Z73ZQFUqFfixUVRC8QAiUifwb1Ag2irOZBbZf/SFT"}]},"_npmUser":{"name":"da-trollefsen","email":"daniel@trollefsen.com"},"directories":{},"maintainers":[{"name":"da-trollefsen","email":"daniel@trollefsen.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/claude-wrapped_1.0.6_1767403872216_0.4186631334373956"},"_hasShrinkwrap":false}},"time":{"created":"2026-01-02T23:59:28.833Z","modified":"2026-01-03T01:31:12.651Z","1.0.2":"2026-01-02T23:04:04.165Z","1.0.3":"2026-01-02T23:11:48.945Z","1.0.0":"2026-01-02T23:59:29.090Z","1.0.1":"2026-01-03T00:02:54.477Z","1.0.6":"2026-01-03T01:31:12.430Z"},"bugs":{"url":"https://github.com/da-troll/claude-wrapped/issues"},"author":{"name":"Daniel Tollefsen"},"license":"MIT","homepage":"https://github.com/da-troll/claude-wrapped#readme","keywords":["claude","anthropic","cli","wrapped","stats","terminal","claude-code","analytics","export","2025","2026","2027"],"repository":{"type":"git","url":"git+https://github.com/da-troll/claude-wrapped.git"},"description":"Your history with Claude Code - a Spotify Wrapped style visual terminal experience.","maintainers":[{"name":"da-trollefsen","email":"daniel@trollefsen.com"}],"readme":"# Claude Code Wrapped\n\n```\n  ░█████╗░██╗░░░░░░█████╗░██╗░░░██╗██████╗░███████╗\n  ██╔══██╗██║░░░░░██╔══██╗██║░░░██║██╔══██╗██╔════╝\n  ██║░░╚═╝██║░░░░░███████║██║░░░██║██║░░██║█████╗░░\n  ██║░░██╗██║░░░░░██╔══██║██║░░░██║██║░░██║██╔══╝░░\n  ╚█████╔╝███████╗██║░░██║╚██████╔╝██████╔╝███████╗\n  ░╚════╝░╚══════╝╚═╝░░╚═╝░╚═════╝░╚═════╝░╚══════╝\n\n            C O D E   W R A P P E D\n                   by Trollefsen\n```\n\n**Your year with Claude Code, Spotify Wrapped style.** ✨\n\nA beautiful terminal experience that analyzes your local Claude Code conversation history and presents your coding year in a cinematic, Spotify Wrapped-inspired format.\n\n---\n\n## 🚀 Quick Start\n\n**No installation needed** - Just run one of these commands:\n\n```bash\n# Using uvx (recommended - Python, no install)\nuvx claude-wrapped\n\n# Using npx (Node.js, no install)\nnpx @da-trollefsen/claude-wrapped\n\n# Or install once and run anytime\npip install claude-wrapped\nclaude-wrapped\n```\n\nThe tool launches in **interactive mode** with arrow-key prompts to guide you through all options. Press `Enter` to advance through your personalized stats!\n\n> **☕ Pro tip:** Using Claude Code? Just paste this repo URL (`https://github.com/da-troll/claude-wrapped`) into your conversation and ask Claude to install and run it for you. Sit back, sip your coffee, and let Claude handle the setup while you wait for your stats. Meta, right? 😎\n\n---\n\n## ✨ Features\n\n### 📊 Comprehensive Stats\n- **Total messages** exchanged with Claude\n- **Coding sessions** and project counts\n- **Tokens processed** (input, output, cache)\n- **Cost estimates** based on official Anthropic pricing\n- **Longest coding streak** with start and end dates\n- **Current streak** to keep you motivated\n\n### 🎬 Cinematic Experience\n- **Dramatic reveals** - Stats appear one at a time, Spotify Wrapped style\n- **GitHub-style contribution graph** - Visualize your coding patterns\n- **Movie-style credits** - Featuring your top tools, projects, and models\n- **Fun facts & insights** - Like \"You coded after midnight 47 times\"\n\n### 🎭 Personality Types\nBased on your coding habits, discover your type:\n- 🦉 **Night Owl** - The quiet hours are your sanctuary\n- 🔥 **Streak Master** - Consistency is your superpower\n- ⚡ **Terminal Warrior** - Command line is your domain\n- 🎨 **The Refactorer** - You see beauty in clean code\n- 🚀 **Empire Builder** - Building across multiple projects\n- 🌙 **Weekend Warrior** - Passion fuels your weekends\n- 🎯 **Perfectionist** - Only the best will do\n- 💻 **Dedicated Dev** - Steady and reliable\n\n### 📤 Export Options\n- **HTML export** - Beautiful web page with interactive graphs\n- **Markdown export** - Clean, readable format for sharing\n- **JSON export** - Raw data for your own analysis\n- **Timestamped filenames** - Never overwrite previous exports\n\n---\n\n## 🎯 Usage\n\n### Two Ways to Use\n\n**🎨 Interactive Mode (Recommended for beginners)**\n\nSimply run the command without any arguments:\n\n```bash\nclaude-wrapped\n```\n\nYou'll be guided through beautiful prompts to select:\n- ⏳ **Time period** - Current year, specific year, or all-time\n- 📤 **Export format** - Terminal only, HTML, Markdown, or JSON\n- 🎬 **Animations** - Show dramatic reveals or skip to dashboard\n- 📝 **Custom filename** - Optional custom name for exports\n\nNo need to remember complex command-line arguments!\n\n**⚡ CLI Mode (For power users & scripts)**\n\nPass arguments directly for quick access:\n\n```bash\n# Full cinematic experience (current year)\nclaude-wrapped 2025\n\n# Skip animations, go straight to dashboard\nclaude-wrapped --no-animate\n\n# All-time statistics\nclaude-wrapped all\n\n# Export to HTML\nclaude-wrapped --html\n\n# Export to Markdown\nclaude-wrapped --markdown\n\n# All-time stats with exports\nclaude-wrapped all --html --markdown\n\n# Export raw data as JSON\nclaude-wrapped --json\n```\n\n### Custom Output Filename\n\n```bash\n# Custom filename (without extension)\nclaude-wrapped --html --output my-wrapped-2025\n# Creates: my-wrapped-2025.html\n\n# Default timestamped filenames\nclaude-wrapped --html\n# Creates: claude-wrapped-2025-20260102-1430.html\n```\n\n---\n\n## 💾 Including Backup Directories\n\nHave Claude Code backups in Dropbox, external drives, or exported conversations? Include them all:\n\n### Setup\n\n```bash\n# 1. Create a .env file\ncp .env.example .env\n\n# 2. Edit .env and add your backup locations (comma-separated)\nCLAUDE_BACKUP_DIRS=~/Dropbox/claude-backups/.claude,~/exported-chats,/Volumes/backup/.claude\n\n# 3. Run as normal - automatically combines all data\nclaude-code-wrapped\n```\n\n### Supported Directory Structures\n\nThe tool auto-detects three different directory layouts:\n\n#### 1. Standard `~/.claude` Structure\n```\nbackup-dir/\n├── projects/\n│   └── -Users-you-code-project/\n│       └── session-uuid.jsonl\n└── history.jsonl (optional)\n```\n\n#### 2. Projects Folder\n```\nprojects-dir/\n├── -Users-you-code-project1/\n│   └── session.jsonl\n└── -Users-you-code-project2/\n    └── session.jsonl\n```\n\n#### 3. Flat Structure\n```\nbackup-dir/\n├── session1.jsonl\n├── session2.jsonl\n└── session3.jsonl\n```\n\n### Deduplication\n\n- Messages are automatically deduplicated by `message_id`\n- **Order matters**: Later directories override earlier ones for duplicates\n- List most authoritative/complete sources **last**\n\n**Example:**\n```bash\n# CORRECT: Pre-compaction backups listed last (highest priority)\nCLAUDE_BACKUP_DIRS=~/.claude/backups/old,~/external-drive/pre-compaction\n\n# WRONG: Pre-compaction backups will be overridden\nCLAUDE_BACKUP_DIRS=~/external-drive/pre-compaction,~/.claude/backups/old\n```\n\n---\n\n## 📋 Requirements\n\n- **Python 3.12+** (with uvx, pipx, or pip)\n- **Or Node.js 16+** (for npx)\n- **Claude Code installed** (`~/.claude/` directory exists)\n\n---\n\n## 🔒 Privacy\n\nThis tool is **100% local and private**:\n\n- ✅ **No network requests** - All data read from local `~/.claude/` directory\n- ✅ **No data collection** - Nothing sent to any server\n- ✅ **No API keys needed** - Works entirely offline\n- ✅ **No secrets exposed** - Only aggregated stats shown, not conversation content\n- ✅ **Open source** - Inspect the code yourself\n\nYour conversations never leave your machine.\n\n---\n\n## 🎨 What You'll See\n\n### Dashboard View\n```\n════════════════════════════════════════════════════════\n  CLAUDE CODE WRAPPED 2025\n════════════════════════════════════════════════════════\n\n   71,108         263          2.9B           40d\n  messages      sessions      tokens      best streak\n\n╭─────────────── Activity · 90 of 365 days ────────────╮\n│  Mon ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■     │\n│      ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■     │\n│  Wed ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■ ■     │\n│                                                      │\n│                Less ■ ■ ■ ■ ■ More                   │\n╰──────────────────────────────────────────────────────╯\n```\n\n### Credits Sequence\n- 💵 **THE NUMBERS** - Cost breakdown by model, total tokens\n- 📅 **TIMELINE** - Journey start, active days, peak coding hour\n- 📊 **AVERAGES** - Messages and cost per day/week/month\n- 🔥 **LONGEST STREAK** - Your best consecutive coding days with dates\n- 💬 **LONGEST CONVERSATION** - Your epic coding session stats\n- ⭐ **STARRING** - Your favorite Claude models\n- 📁 **PROJECTS** - Top projects by message count\n\n---\n\n## 🛠️ How It Works\n\nReads your local Claude Code conversation history from `~/.claude/projects/` and aggregates:\n\n- **Message counts** and timestamps\n- **Token usage** (input, output, cache reads/writes)\n- **Tool usage** (Bash, Read, Edit, Grep, etc.)\n- **MCP server usage** (extracted from tool names)\n- **Model preferences** (Opus, Sonnet, Haiku)\n- **Project activity** (intelligently aggregates common subdirectories)\n- **Coding patterns** (hourly distribution, weekday patterns, streaks)\n- **Cost estimates** (based on official Anthropic API pricing)\n\n### Intelligent Project Aggregation\n\nThe tool recognizes common subdirectories and aggregates them properly:\n\n```python\n# Both of these become \"my-project\":\n/Users/you/code/my-project/app\n/Users/you/code/my-project/src\n\n# Common subdirectories recognized:\napp, src, lib, frontend, backend, api, server, client,\ntest, tests, public, static, dist, build, etc.\n```\n\n---\n\n## 📦 Installation Methods\n\n### 🚀 No Install Required (Recommended)\n\n**uvx** (Python ecosystem - most reliable):\n```bash\nuvx claude-wrapped\n```\n- ✅ No installation needed\n- ✅ Always runs latest version\n- ✅ Isolated environment\n- ✅ Requires Python 3.12+ or `uv` installed\n\n**npx** (Node.js ecosystem):\n```bash\nnpx claude-wrapped\n```\n- ✅ No installation needed\n- ✅ Works if you have Node.js 16+\n- ⚠️ Wrapper script that calls Python version\n\n### 📥 Install Globally\n\n**pip** (system-wide Python install):\n```bash\npip install claude-wrapped\nclaude-wrapped\n```\n- Installs `claude-wrapped` command globally\n- Requires Python 3.12+\n\n**pipx** (isolated Python install):\n```bash\npipx install claude-wrapped\nclaude-wrapped\n```\n- ✅ Best of both worlds: installed command + isolated environment\n- ✅ Doesn't pollute global Python packages\n- Requires `pipx` ([installation guide](https://pipx.pypa.io/stable/installation/))\n\n**Homebrew** (macOS/Linux package manager):\n```bash\nbrew tap da-troll/claude-wrapped\nbrew install claude-wrapped\n```\n- ✅ Native macOS/Linux package manager\n- ✅ Easy updates with `brew upgrade`\n- Tap repository: [homebrew-claude-wrapped](https://github.com/da-troll/homebrew-claude-wrapped)\n\n### 🔧 Development Mode\n\n**From source** (for contributors):\n```bash\ngit clone https://github.com/da-troll/claude-wrapped.git\ncd claude-wrapped\nuv sync\nuv run python -m claude_code_wrapped\n```\n\n**Editable install** (makes `claude-wrapped` command available locally):\n```bash\nuv pip install -e .\nclaude-wrapped\n```\n\n---\n\n## 🤝 Contributing\n\nContributions are welcome! This project is open source and community-driven.\n\n### Development Setup\n\n```bash\n# Clone the repository\ngit clone https://github.com/da-troll/claude-wrapped.git\ncd claude-wrapped\n\n# Install dependencies with uv\nuv sync\n\n# Run from source\nuv run python -m claude_code_wrapped\n\n# Run tests\nuv run python -m claude_code_wrapped.reader\nuv run python -m claude_code_wrapped.stats\n```\n\n---\n\n## 📄 License\n\nMIT - see [LICENSE](LICENSE) for details.\n\n---\n\n## ⭐ Show Your Support\n\nIf you found this useful, consider:\n- Giving it a star on GitHub ⭐\n- Sharing your wrapped on social media\n- Contributing improvements\n\n---\n\n**Built with ❤️ for the Claude Code community**\n\n---\n\n## 💡 Inspired By\n\nOriginally inspired by [Mert Deveci](https://x.com/gm_mertd)'s concept. This project has since evolved into a completely independent codebase with a different architecture and feature set.\n","readmeFilename":"README.md"}