Complementing cd with autojump
Autojump is a mature and widely available command-line tool for navigating your directory structure. We show you how it works.
The Linux directory structure was developed when hard drives were small, and all you needed for navigation was a file manager or a handful of commands like
ls. Today, however, multiterabyte hard drives make the list of directories longer and deeper and therefore more difficult to navigate. On the desktop, these changes have prompted navigation alternatives like Nepomuk  and Zeitgeist . At the command line, they have resulted in several different solutions, the most popular of which is autojump .
Autojump apparently takes its name from a means of pre-programming moves in some of the games in The Legend of Zelda series. Like its gaming namesake, autojump is a means of jumping straight to a directory without laboriously following its full path. Autojump maintains a plain-text database of the directories you visit and how often you visit each one and, on the basis of this information, jumps to the closest match according to what you type.
As the project homepage notes, "autojump isn't meant to be a drop-in replacement for cd, but rather a complement. Cd is fine when staying in the same area of the filesystem; autojump is there to help when you need to jump far away from your current location." Autojump is especially useful with the root account, which tends to make longer jumps in the directory structure than most accounts.
Many major distributions, including Debian, Fedora, ArchLinux, Gentoo, Frugalware, and Slackware, carry autojump in their repositories. Versions also exist for OS X and Windows. You can also install autojump by cloning the project's Git repository with the command
then switching to the download directory and running the script
Before choosing your installation method, you might want to check how recent your distribution's version is and check its limitations. For example, the man page for v20, the version of autojump in Debian Stable, states that it does not run on the zsh shell, nor in Gnome 3.0 or LXDE. You can keep track of other limitations on the projects Issue page .
To activate autojump, enter:
Immediately after installation, the database will be empty, and autojump will not be functional. To get it working, you must either visit a few directories using cd, or else add directories manually to the database with
autojump -a DIRECTORY or autojump --add DIRECTORY
As you might expect, the more you use autojump, the more accurate and useful it becomes. You can view the contents of the database (Figure 1) with either of these commands:
autojump --stat jumpstat
In addition to the complete directory path, the autojump database also assigns a key weight to each entry, based on the amount of time you spend in the directory. By default, each entry's weight decays over time – in other words, if you start moving less frequently to a directory, autojump will gradually become less likely to suggest it as a target into which to jump. To prevent such weight decay, you can use the command structure
autojump -a DIRECTORY --completion.
You can also edit
~/.local/share/autojump/autojump.txt, both to add paths and to adjust weights. These manual edits can be especially useful if you have two directories with similar names, such as
~/work/scripts, but you want to ensure that autojump suggests one in preference to the other. To remove a directory from the database, give it a negative weight and save the file. After all your edits, restart autojump so that it is using the latest figures.
Once the database has enough contents to be useful, start autojump. To jump to a directory, use the command
j DIRECTORY. Type as much of the directory name as you think necessary, and autojump will try to match what you type with its database entries, printing its nearest match in red and switching to its suggestion (Figure 2). If two database entries match your typing, autojump suggests the first in alphabetical order. Autojump has no way of choosing the second until you type more.
Note that all database entries are case-insensitive. If you are regularly moving between directories in a command-line session, you might periodically run the
jumpstat command so that you can see autojump's entries and type the minimum possible to jump. You do not need to type the full path, but remember that autojump only works in the instance of a terminal in which it is started. If you start autojump in one terminal, then open a second tab, it will not be active in the second tab unless you specifically start it in the second tab.
Should the directory contain a space or other illegal character – which can easily happen if the directory is created from the desktop – add the
--bash option and enclose the name in single or double quotation marks so that autojump will try to match the entire string. Otherwise, autojump will not locate a match, even if the directory is listed in the database without quotation marks.
By default, autojump tries to reduce database entries by treating symbolic links as paths to the original directory. However, if you prefer the slightly quicker results of listing symbolic links separately, add the
export AUTOJUMP_KEEP_SYMLINKS=1 line to your
Other Jump Tools
Autojump is not the only tool that uses a database for faster navigation. One very similar program is z . It works much like autojump but includes some additional features, such as restricting matches to subdirectories of the present working directory and distinguishing between overall rank or weight and recent access. A similar tool called v  is a Vim extension that works with the list of recently opened files.
Another similar tool is FASD , which uses capacities similar to autojump or z to find and open files as well as directories. FASD also includes unique aliases and environmental variables to improve its performance.
Both z and FASD have features that would enhance autojump. Some day, either may surpass autojump. However, for now, autojump remains the most mature and widely available jump tool. Unless its interface limitations affect you, autojump is quick to learn and can seriously reduce your typing as you navigate your constantly deepening and lengthening directory structure.
- Nepomuk: https://en.wikipedia.org/wiki/NEPOMUK_%28framework%29
- Zeitgeist: http://zeitgeist-project.com/
- Autojump: https://github.com/joelthelion/autojump
- Autojump Issues: https://github.com/joelthelion/autojump/issues
- z: https://github.com/rupa/z
- v: https://github.com/rupa/v
- FASD: https://github.com/clvv/fasd
Buy this article as PDF
Popular open source encryption tool is vulnerable to attack
New “Yakkety Yak” edition emphasizes cloud and servers
Google finally enters the phone hardware business.
Innovative system adds a hard drive and Ubuntu Core to the RPi for an IoT hub.
Linux is two weeks younger than we thought!
The Apache Software Foundation considers retiring OpenOffice
Adobe won’t kill the plugin in 2017
Linux Foundation's big event celebrates the 25th anniversary of Linux
Linux has evolved from “won’t be a professional” project to one of the most professional software projects in the history of computers.