Skip to content


Subversion checkout URL

You can clone with
Download ZIP
[DEPRECATED] Quickly change directory on your shell without typing the whole path
Python Shell
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Quickly is a small python command-line script enabling you to do change directory (cd) without having to type the whole path. It does this by mapping a specified key to the path. The key and the path are set by the user.

WARNING: Alpha Quality Software

The software has been unit tested. But in no way I'm claiming that the tests are complete.

The software has also been tested manually on ArchLinux, and is running as expected. But please see the TODO section below to know why I still consider this an alpha quality software.


We want to be able to cd quickly to the path: /path/to/a/directory. So the step is:

$ q -a a_dir /path/to/a/directory

The above command will tell quickly to store /path/to/a/directory as a_dir.

To cd to /path/to/a/directory, you just type:

$ q a_dir

And quickly will change your current working directory to /path/to/a/directory.

Other Available Options

To remove a key from quickly, run:

$ q -rm a_dir

To update a key and map it to a different path:

$ q -e a_dir /another/path

To show the list of key and its mapped path:

$ q -ls


Currently, the installation process sucks.

  1. Clone this repo
  2. Link the file to a path that is recognised by your command line $PATH environment.
  3. add the content of q.bash (not including #!/bin/bash) to .bashrc
  4. run source .bashrc

I'm still studying how to distribute this software properly. What's proper?

Well, I want the user to be able to run q (as shown by examples above) when the user opens a terminal/console. Currently, I don't know how to do that.


Please do :D. Just clone this repo and do a pull request for any feature that you think would be great to be added to this project.


python -m unittest tests/*.py -v

I'm also still finding a way to run the test easily.


  1. Autocompletion
  2. Better way to install and distribute
  3. Easier step to test
Something went wrong with that request. Please try again.