autojump 0,2,3,0,4,0,3,6 travis-ci

A cd command that learns - easily navigate directories from the command line


autojump - a faster way to navigate your filesystem


autojump is a faster way to navigate your filesystem. It works by maintaining a database of the directories you use the most from the command line.

Directories must be visited first before they can be jumped to.


j is a convenience wrapper function around autojump. Any option that can be used with autojump can be used with j and vice versa.

  • Jump To A Directory That Contains foo:

    j foo
  • Jump To A Child Directory:

    Sometimes it’s convenient to jump to a child directory (sub-directory of current directory) rather than typing out the full name.

    jc bar
  • Open File Manager To Directories (instead of jumping):

    Instead of jumping to a directory, you can open a file explorer window (Mac Finder, Windows Explorer, GNOME Nautilus, etc.) to the directory instead.

    jo music

    Opening a file manager to a child directory is also supported:

    jco images
  • Using Multiple Arguments:

    Let’s assume the following database:

    30   /home/user/mail/inbox
    10   /home/user/work/inbox

    j in would jump into /home/user/mail/inbox as the higher weighted entry. However you can pass multiple arguments to autojump to prefer a different entry. In the above example, j w in would then change directory to /home/user/work/inbox.

For more options refer to help:

autojump --help



  • Python v2.6+ except v3.2
  • Supported shells:
    • bash v4.0+
    • zsh
    • fish
    • tcsh (experimental)
    • clink (Windows, experimental)



autojump is included in the following distro repositories, please use relevant package management utilities to install (e.g. yum, apt-get, etc):

  • Debian testing/unstable, Ubuntu, Linux Mint

    All Debian-derived distros require manual activation for policy reasons, please see /usr/share/doc/autojump/README.Debian.

  • RedHat, Fedora, CentOS (install autojump-zsh for zsh, autojump-fish for fish, etc.)

  • ArchLinux

  • Gentoo

  • Frugalware

  • Slackware


Homebrew is the recommended installation method for Mac OS X:

brew install autojump

MacPorts also available:

port install autojump


Windows support is enabled by clink which should be installed prior to installing autojump.


Grab a copy of autojump:

git clone git://

Run the installation script and follow on screen instructions.

cd autojump
./ or ./


  • autojump does not support directories that begin with -.

  • For bash users, autojump keeps track of directories by modifying $PROMPT_COMMAND. Do not overwrite $PROMPT_COMMAND:

    export PROMPT_COMMAND="history -a"

    Instead append to the end of the existing \$PROMPT_COMMAND:



For any questions or issues please visit:


autojump was originally written by Joël Schaerer, and currently maintained by William Ting. More contributors can be found in AUTHORS.


Copyright © 2016 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

Related Repositories



A cd command that learns - easily navigate directories from the command line ...



Command-line productivity booster, offers quick access to files and directories, inspired by autojump, z and v. ...



semi clone of autojump ( in shell/awk ...



A cd command that learns - easily navigate directories from the command line ...



Brings the power of Autojump to Vim. ...

Top Contributors

wting joelthelion blueyed elcerdo xiaonaitong mdlawson jkuan jsliang mineo statik213 ElArtista palfrey a13xb erdiaker shelhamer jared-hess JrCs khughitt liyanchang marekjm sudish jjk-jacky jostber chbrown anl lendenmc AeonAxan vad erbridge halilim


-   release-v22.3.5 zip tar
-   release-v22.3.4 zip tar
-   release-v22.3.3 zip tar
-   release-v22.3.2 zip tar
-   release-v22.3.1 zip tar
-   release-v22.3.0 zip tar
-   release-v22.2.4 zip tar
-   release-v22.2.2 zip tar
-   release-v21.7.1 zip tar
-   release-v21.6.9 zip tar
-   release-v21.6.8 zip tar
-   release-v21.5.8 zip tar
-   release-v21.5.1 zip tar
-   release-v21.4.2 zip tar
-   release-v21.3.0 zip tar
-   release-v21.2.1 zip tar
-   release-v21.2.0 zip tar
-   release-v21.1.4 zip tar
-   release-v21.1.2 zip tar
-   release-v21.1.0 zip tar
-   release-v21.0.5 zip tar
-   release-v21.0.3 zip tar
-   release-v21.0.2 zip tar
-   release-v20.9 zip tar
-   release-v20.8 zip tar
-   release-v20.7 zip tar
-   release-v20.6 zip tar
-   release-v20.5 zip tar
-   release-v20 zip tar
-   release-v19 zip tar