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!

Search for frequently visited directories

Project Description


[![Build Status](](

This package is used to record the frequency of visits to particular directories through the ‘cd’ function. The goal is to use this information to provide a way to quickly navigate to commonly visited directories.

To incorporate this functionality, install the package in the usual way,

python install

This will add the cdhistory packacge to your python install area, and a cdhistory script to /usr/local/bin. To incorporate cdhistory into your normal ‘cd’ use, there is a bash script installed in /usr/local/share called cdhistory.bash that provides an function to wrap ‘cd’.

The cdhistory.bash snippet replaces the existing ‘cd’ function in bash with a wrapped version. The function behaves like the builtin cd command normally, but records the directories that are visited. However, if you prepend the first argument to ‘cd’ with a colon it will go to the best match using cdhistory, e.g.

cd :repos

will ‘cd’ to the path that best matches the string ‘repos’. In effect, this is like creating aliases for commonly visited directories.

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
(5.3 kB) Copy SHA256 Hash SHA256
Source None Jul 17, 2015

Supported By

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 Google Google Cloud Servers DreamHost DreamHost Log Hosting