cmd-wrapped

Generate your command-line wrapped summary

$ cmd-wrapped

$ cmd-wrapped --shell [bash|zsh|fish]

$ cmd-wrapped --history-file [path/to/.bash_history]

$ cmd-wrapped --year [2024]

$ cmd-wrapped --json

$ cmd-wrapped --verbose

cmd-wrapped [options]

cmd-wrapped is a command-line tool that generates a "Spotify Wrapped" style summary of your terminal command history. It analyzes your shell history file to produce statistics about your most-used commands, busiest hours, and command patterns throughout the year.
The tool automatically detects your default shell and locates the appropriate history file. It presents colorful, formatted output showing top commands, total commands executed, unique commands used, and temporal usage patterns.
cmd-wrapped supports multiple shells including Bash, Zsh, and Fish, and can process custom history files for analysis. The JSON output option enables integration with other tools or custom visualizations of your command-line habits.

--shell SHELL

Specify which shell history to analyze (bash, zsh, fish).

Path to a custom history file to analyze.

Generate statistics for a specific year only.

Output results in JSON format for scripting.

Show additional detailed statistics.

Disable colored output.

Display help information.

Display version information.

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)