Spotify Wrapped for your git history — beautiful year-in-code stats right in your terminal
npx git-wrappedNo installation. No internet. Works in any git repository.
# Current year, auto-detect author
npx git-wrapped
# Different year and theme
npx git-wrapped --year 2023 --theme purple
# All-time history
npx git-wrapped --all-time
# Compare two years
npx git-wrapped --compare 2023
# Specific branch
npx git-wrapped --branch main
# Save card to file
npx git-wrapped --save wrapped-2025.txt
# JSON output for scripting
npx git-wrapped --json > stats.json
# Analyze another repo
npx git-wrapped --repo ~/projects/my-app| Flag | Description | Default |
|---|---|---|
-y, --year <year> |
Year to analyze | Current year |
-a, --author <pattern> |
Filter by author name/email (passed to git --author, supports partial match) |
Auto-detected |
--all-authors |
Show all contributors combined | — |
-b, --branch <branch> |
Branch to analyze | HEAD |
-r, --repo <path> |
Path to repository | Current dir |
--since <date> |
Start date YYYY-MM-DD |
— |
--until <date> |
End date YYYY-MM-DD |
— |
--all-time |
Analyze entire git history | — |
--full |
Remove 3K commit limit (slower) | — |
--top <n> |
Number of languages to show | 7 |
--ignore-ext <list> |
Comma-separated extensions to skip | — |
--compare <year> |
Compare with another year | — |
--theme <name> |
green / blue / purple / orange / mono |
green |
--no-animation |
Disable animations | — |
--json |
Output JSON (ISO 8601 dates) | — |
--save <file> |
Save summary card to text file | — |
| Key | Action |
|---|---|
→ or Space |
Next screen |
← |
Previous screen |
Q or Esc |
Quit |
S |
Share on Twitter (Final screen) |
B |
Share on Bluesky (Final screen) |
C |
Copy card to clipboard (Final screen) |
- Node.js >= 18
- git
[](https://github.com/romimur/git-wrapped)MIT
Telegram: @vhodvai