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

Release History

This version
History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
shellstats-0.1-py2.py3-none-any.whl (3.9 kB) Copy SHA256 Checksum SHA256 py2.py3 Wheel Nov 29, 2014
shellstats-0.1.tar.gz (2.9 kB) Copy SHA256 Checksum SHA256 Source Nov 29, 2014

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting