ccwrap
v0.3.1
Published
Claude Code Wrapped - Your AI coding stats, meme-ified into a shareable video
Maintainers
Readme
ccwrap
Your Claude Code usage stats, meme-ified into a shareable video. Like Spotify Wrapped, but for your AI coding assistant.
Quick Start
npx ccwrapOr install globally:
npm install -g ccwrapUsage
# Last month (default)
ccwrap
# Last week
ccwrap --period week
# Last quarter
ccwrap --period quarter
# All time
ccwrap --period all
# Custom date range
ccwrap --since 2025-06-01
ccwrap --since 2025-06-01 --until 2025-12-31
# Dark mode - environmental impact commentary
ccwrap --mode dark
# Custom output path
ccwrap -o my-wrapped.mp4
# Just print stats, no video
ccwrap --stats-only
# Output stats as JSON
ccwrap --jsonTime Periods
By default, ccwrap recaps the last 30 days. Use --period for presets or --since/--until for custom ranges.
| Flag | Period |
|---|---|
| --period week | Last 7 days |
| --period month | Last 30 days (default) |
| --period quarter | Last 90 days |
| --period all | All time |
| --since YYYY-MM-DD | Custom start date (until today) |
| --since ... --until ... | Custom date range |
AI Commentary
Set ANTHROPIC_API_KEY to get AI-generated personalized commentary on each slide. Without it, pre-written fallback quips are used.
export ANTHROPIC_API_KEY=sk-ant-...
ccwrapModes
| Sassy (default) | Dark (--mode dark) |
|---|---|
| Purple/cyan neon aesthetic | Blood red/stone aesthetic |
| Meme humor ("that's 50 coffees") | Environmental impact ("4.5L of water used") |
| Affectionate roasting | Uncomfortable truths, but funny |
Video Slides
- Intro - Claude Code Wrapped with period-aware tagline
- Tokens - Total tokens with counting animation
- Cost - Dollar amount + fun equivalents
- Model - Favorite model reveal + usage breakdown
- Busiest Day - Peak day with activity chart
- Sessions - Marathon stats, streaks, scores
- Peak Hours - 24h activity histogram
- Archetype - Your coding personality
- Summary - Shareable card with all stats
Requirements
- Node.js >= 18
- Chrome/Chromium (auto-downloaded by Remotion if not found)
- Claude Code usage data in
~/.claude/projects/
