YiNNx / cmd-wrapped

👩‍💻 A CLI Tool for Command Line Insights

English / 简体中文

cmd-wrapped

👩‍💻 Rust-Based Unix Shell History Analyzer

 

Features

• Analyze the commandline activity distribution for months, days and hours
• Github-style command distribution graph
• Supported shell / history tool:
  • zsh
  • bash
  • fish
  • atuin

How to Use

Installation

• Using cargo

cargo install cmd-wrapped

• Download from Release

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

• Nix❄️

nix run nixpkgs#cmd-wrapped

• Arch

yay -S 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, 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 Zsh / Bash tracking the timestamp for each command, which requires configuring specific options extraly:

• For Zsh - EXTENDED_HISTORY (oh-my-zsh has it enabled by default)
• For Bash - HISTTIMEFORMAT

Commands executed before configuring the option won't be recorded with a timestamp and this will affect cmd-wrapped’s stats. If you find all your stats showing as 0, consider configuring the option now to view the cmd-wrapped stats next year :P

Credits & License

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