cmd-wrapped

cmd-wrapped [-s shell] [year]

cmd-wrapped is a command-line tool that generates a "Spotify Wrapped" style summary of your terminal command history. It analyzes your shell history to produce statistics about your most-used commands, busiest hours, and command patterns over time.The tool reads the history of the detected (or specified) shell and presents colorful, formatted output showing top commands, total commands executed, unique commands used, and temporal usage patterns.cmd-wrapped supports Zsh, Bash, Fish, Nushell, and Atuin. Pass a year as a positional argument to scope the report to that year, or `-s` to choose which shell's history to analyze.

-s shell

Specify which shell history to analyze: zsh, bash, fish, nu (nushell), or atuin.

Positional argument selecting a specific year (e.g., 2024). Without it, current statistics are shown.

Accuracy depends on your shell's history configuration. Commands may be undercounted if history is limited in size, duplicates are ignored, or certain commands are excluded from history. Fish shell uses a different history format that requires specific parsing.

cmd-wrapped was created as a fun end-of-year tool inspired by Spotify Wrapped, the popular annual music listening summary. It emerged from the developer community's interest in personal analytics and the trend of "wrapped" summaries across various platforms.

history(1), bash(1), zsh(1), fish(1)

Source code