Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Show the most used shell commands.

Project Description

Shellstats reads your shell history and shows you the most used commands. Typical output looks like:

   Command              Count      Percentage
 1 ls                   326        17.0%
 2 cd                   254        13.3%
 3 less                 172        8.99%
 4 sudo                 162        8.47%
 5 emacs                159        8.31%
 6 screen               146        7.63%
 7 echo                 103        5.38%
 8 top                  100        5.23%
 9 du                   85         4.44%
10 grep                 70         3.66%


Install it with a simple:

$ pip install shellstats

In addition if you want to see a pie chart of the above output, you need to have matplotlib installed (package ‘python-matplotlib’ in Debian/Ubuntu/Fedora).


Usage: shellstats [OPTIONS]

  Print the most frequently used shell commands.

  --n INTEGER          How many commands to show.
  --plot               Plot command usage in pie chart.
  --command TEXT       Most frequent subcommands for command, e.g. sudo, git.
  --history-file PATH  Read shell history from history-file.
  --shell TEXT         Specify shell history format: bash, fish or zsh.
  --help               Show this message and exit.

Release History

This version
History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(3.9 kB) Copy SHA256 Hash SHA256
Wheel py2.py3 Nov 29, 2014
(2.9 kB) Copy SHA256 Hash SHA256
Source None Nov 29, 2014

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Kabu Creative Kabu Creative UX & Design Google Google Cloud Servers Fastly Fastly CDN StatusPage StatusPage Statuspage DigiCert DigiCert EV Certificate