shellwrapped

Spotify Wrapped for your terminal.
Your shell history's year in review: top commands, git habits, typos, 2am sessions, and your terminal personality. Plus a card to share.

uvx shellwrapped        # or: pipx run shellwrapped

When it's done, you get a card like this saved next to you:

_{Demo and card generated from a synthetic year of history.}

What it finds

• Your top commands, counted properly through pipes, &&, sudo, env and VAR=value prefixes
• Your git habits: how many git status it takes you to feel safe
• Your most-repeated command: a strong hint it deserves an alias
• Your typos: gti, sl, claer, pyhton, cd.., and friends
• When you work: your rush hour, your longest session, your busiest day, how much happens after 10pm
• Habits: sudo !!, rm -rf, git push --force, cd immediately followed by ls
• Your terminal personality: The Night Shell, The Git Whisperer, The Container Captain, The Pythonista, The Speed Typist, ...

Works with zsh, bash, fish and PowerShell on macOS, Linux and Windows. It finds your history files automatically, including zsh's extended format with multi-line commands.

Private by design

• Everything runs locally. No network requests.
• The share card shows only counts and program names (git, docker), never full commands, paths or arguments.
• Anything token-shaped is masked before a command is shown in your terminal.

Options

shellwrapped --all-time            # your whole history instead of this year
shellwrapped --year 2025
shellwrapped --no-anim             # skip the animation, just the summary
shellwrapped --file ~/.zsh_history --shell zsh
shellwrapped --card wrapped.png    # where to save the card (or --no-card)

Year-by-year stats need timestamps in your history. zsh's EXTENDED_HISTORY and fish record them automatically. In bash, add export HISTTIMEFORMAT='%F %T ' to your .bashrc. Without timestamps, shellwrapped covers everything your history remembers.

License

MIT. Bundles the Inter typeface under the SIL Open Font License.