cmd-wrapped

     

A CLI to view your shell history stats, with support for zsh, bash, fish, nushell, and atuin.

Installation

• Use Cargo

cargo install cmd-wrapped

• Download from Release

Unzip, chmod and run the binary file in the terminal.

• Archlinux

yay -S cmd-wrapped

• Nix❄️

nix run nixpkgs#cmd-wrapped

Usage

# fetch current stats
cmd-wrapped

# fetch annual shell history stats for a specific year
cmd-wrapped 2024

# specify the target shell
cmd-wrapped -s <shell>

Supported options for <shell> : zsh, bash, fish, nu (nushell), atuin.

[!NOTE]

In some cases, cmd-wrapped may fail to output correct data (such as all outputs being 0). This is because it relies on the timestamp track for each command, which sometimes requires configuring specific options extraly:

• For Zsh - EXTENDED_HISTORY (oh-my-zsh has it enabled by default)
• For Bash - HISTTIMEFORMAT (To enable it, run this command: echo 'HISTTIMEFORMAT="%Y/%m/%d %H:%M:%S "' >> ~/.bashrc )
• For Nushell - Enable SQLite history storage: $env.config.history.file_format = "sqlite"

Commands executed before configuring the option won't be recorded with a timestamp and this will affect cmd-wrapped’s stats.

Credits & License

• Special thanks to @jyi2ya for the cooool idea!
• License: MIT