#command-line #zsh #fish #shell #shell-history #atuin

app cmd-wrapped

A CLI to view your command line stats for the past years. Support zsh, bash, fish as well as atuin.

2 unstable releases

0.3.0 Feb 5, 2024
0.2.0 Jan 17, 2024

#88 in Science

Download history 58/week @ 2024-01-27 41/week @ 2024-02-03 9/week @ 2024-02-10 35/week @ 2024-02-17 39/week @ 2024-02-24 20/week @ 2024-03-02 18/week @ 2024-03-09 12/week @ 2024-03-16 15/week @ 2024-03-23 19/week @ 2024-03-30 5/week @ 2024-04-06

111 downloads per month

MIT license

731 lines

English / 简体中文


Find out what the past year looks like in command line!

Stars   Release


  • Analyze the commandline activity distribution for months, weekdays and hours, as well as frequently-used commands over the past years.

  • Github-style command distribution graph

  • Supported shell / history tool:

    • zsh
    • bash
    • fish
    • atuin
  • A cute Ferris on the cover

How to Use


  • Install using cargo

    cargo install cmd-wrapped
  • Download from Release, unzip and run the binary file in the terminal:



cmd-wrapped [<year>] [-s <shell>] 

# e.g.
cmd-wrapped               # for the past year & current shell
cmd-wrapped 2024 -s zsh   # specify the year & the shell type

Supported options for <shell> : zsh, bash, fish, atuin.


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:

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


~163K SLoC