Complementing cd with autojump
Big Jump

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 cd
and 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 [1] and Zeitgeist [2]. At the command line, they have resulted in several different solutions, the most popular of which is autojump [3].
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
https://github.com/joelthelion/autojump
then switching to the download directory and running the script ./install.py
.
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 [4].
Training autojump
To activate autojump, enter:
./usr/share/autojump/autojump.sh
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 ~/scripts
and ~/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.
Using autojump
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 -b
or --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 ~/.bashrc
file.
Other Jump Tools
Autojump is not the only tool that uses a database for faster navigation. One very similar program is z [5]. 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 [6] is a Vim extension that works with the list of recently opened files.
Another similar tool is FASD [7], 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.
Infos
- 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
(incl. VAT)
Buy Linux Magazine
Subscribe to our Linux Newsletters
Find Linux and Open Source Jobs
Subscribe to our ADMIN Newsletters
Support Our Work
Linux Magazine content is made possible with support from readers like you. Please consider contributing when you've found an article to be beneficial.
News
-
The GNU Project Celebrates Its 40th Birthday
September 27 marks the 40th anniversary of the GNU Project, and it was celebrated with a hacker meeting in Biel/Bienne, Switzerland.
-
Linux Kernel Reducing Long-Term Support
LTS support for the Linux kernel is about to undergo some serious changes that will have a considerable impact on the future.
-
Fedora 39 Beta Now Available for Testing
For fans and users of Fedora Linux, the first beta of release 39 is now available, which is a minor upgrade but does include GNOME 45.
-
Fedora Linux 40 to Drop X11 for KDE Plasma
When Fedora 40 arrives in 2024, there will be a few big changes coming, especially for the KDE Plasma option.
-
Real-Time Ubuntu Available in AWS Marketplace
Anyone looking for a Linux distribution for real-time processing could do a whole lot worse than Real-Time Ubuntu.
-
KSMBD Finally Reaches a Stable State
For those who've been looking forward to the first release of KSMBD, after two years it's no longer considered experimental.
-
Nitrux 3.0.0 Has Been Released
The latest version of Nitrux brings plenty of innovation and fresh apps to the table.
-
Linux From Scratch 12.0 Now Available
If you're looking to roll your own Linux distribution, the latest version of Linux From Scratch is now available with plenty of updates.
-
Linux Kernel 6.5 Has Been Released
The newest Linux kernel, version 6.5, now includes initial support for two very exciting features.
-
UbuntuDDE 23.04 Now Available
A new version of the UbuntuDDE remix has finally arrived with all the updates from the Deepin desktop and everything that comes with the Ubuntu 23.04 base.