git-wrapped

Spotify Wrapped for your git history — beautiful year-in-code stats right in your terminal

Quick Start

npx git-wrapped

No installation. No internet. Works in any git repository.

Examples

# 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

Options

| 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 | — |

Navigation

| 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) |

Requirements

• Node.js >= 18
• git

Add to your profile README

[![Git Wrapped](https://img.shields.io/badge/git--wrapped-2025-39d353?style=flat-square&logo=git&logoColor=white)](https://github.com/romimur/git-wrapped)

License

MIT