table of contents
autojump(1) | General Commands Manual | autojump(1) |
NAME¶
autojump - a faster way to navigate your filesystemSYNOPSIS¶
Load autojump:-
. /usr/share/autojump/autojump.sh
-
j foo
-
jc bar
-
j --stat
DESCRIPTION¶
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.OPTIONS¶
Options must be passed to 'autojump' and not the 'j' wrapper function.-
-i, --increase manually increase current directory weight -d, --decrease manually decrease current directory weight --purge deletes database entries that no longer exist on system -s, --stat show general stats and top 100 database entries --version show version information and exit
ADVANCED USAGE¶
- •
- Using Multiple Arguments
Let's assume the following database:
-
30 /home/user/mail/inbox 10 /home/user/work/inbox
- •
- 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 images
- •
- 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
-
jco images
ADDITIONAL CONFIGURATION¶
- •
- Enable ZSH Tab Completion
ZSH tab completion requires the compinit module to be loaded. Please add the
following line to your ~/.zshrc after loading autojump:
-
autoload -U compinit && compinit
-
autoload -U compinit && compinit -u
- •
- Always Ignore Case
Default behavior is to prioritize exact matches over all else. For example,
j foo will prefer /foobar over /FooBar even if the latter has a higher
weight. To change this behavior and ignore case, add the following
environmental variable in your ~/.bashrc:
-
export AUTOJUMP_IGNORE_CASE=1
- •
- Prefer Symbolic Links
Default behavior is to evaluate symbolic links into full paths as to reduce
duplicate entries in the database. However, some users prefer a shorter
working directory path in their shell prompt. To switch behavior to prefer
symbolic links, add the following environmental variable in your ~/.bashrc:
-
export AUTOJUMP_KEEP_SYMLINKS=1
- •
- Autocomplete Additional Commands (Bash only)
Autojump can be used to autocomplete other commands (e.g. cp or vim). To use
this feature, add the following environmental variable in your ~/.bashrc:
-
export AUTOJUMP_AUTOCOMPLETE_CMDS='cp vim'
KNOWN ISSUES¶
- •
- For bash users, autojump keeps track of directories as a pre-command hook by modifying $PROMPT_COMMAND. If you overwrite $PROMPT_COMMAND in ~/.bashrc you can cause problems. Don't do this:
-
export PROMPT_COMMAND="history -a"
-
export PROMPT_COMMAND="${PROMPT_COMMAND:+$PROMPT_COMMAND ;} history -a"
- •
- The jump function j does not support directories that begin with -. If you want to jump a directory called --music, try using j music instead of j --music.
FILES¶
If installed locally, autojump is self-contained in ~/.autojump/. The database is stored in $XDG_DATA_HOME/autojump/autojump.txt.REPORTING BUGS¶
For any usage related issues or feature requests please visit: https://github.com/joelthelion/autojump/issuesTHANKS¶
Special thanks goes out to: Pierre Gueth, Simon Marache-Francisco, Daniel Jackoway, and many others.AUTHORS¶
autojump was originally written by Joël Schaerer, and currently maintained by William Ting.COPYRIGHT¶
Copyright © 2012 Free Software Foundation, Inc. License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.10 April 2012 | release-v20 |