1autojump(1)                                                        autojump(1)
2
3
4
5   NAME
6       autojump - a faster way to navigate your filesystem
7
8   DESCRIPTION
9       autojump  is  a  faster  way  to navigate your filesystem.  It works by
10       maintaining a database of the directories you use  the  most  from  the
11       command line.
12
13       Directories must be visited first before they can be jumped to.
14
15   USAGE
16       j  is  a convenience wrapper function around autojump.  Any option that
17       can be used with autojump can be used with j and vice versa.
18
19       • Jump To A Directory That Contains foo:
20
21                  j foo
22
23       • Jump To A Child Directory:
24
25         Sometimes it’s convenient to jump to a child directory (sub-directory
26         of current directory) rather than typing out the full name.
27
28                  jc bar
29
30       • Open File Manager To Directories (instead of jumping):
31
32         Instead  of jumping to a directory, you can open a file explorer win‐
33         dow (Mac Finder, Windows Explorer, GNOME Nautilus, etc.)  to the  di‐
34         rectory instead.
35
36                  jo music
37
38         Opening a file manager to a child directory is also supported:
39
40                  jco images
41
42       • Using Multiple Arguments:
43
44         Let’s assume the following database:
45
46                  30   /home/user/mail/inbox
47                  10   /home/user/work/inbox
48
49         j in would jump into /home/user/mail/inbox as the higher weighted en‐
50         try.  However you can pass multiple arguments to autojump to prefer a
51         different  entry.  In the above example, j w in would then change di‐
52         rectory to /home/user/work/inbox.
53
54       For more options refer to help:
55
56              autojump --help
57
58   KNOWN ISSUES
59       • autojump does not support directories that begin with -.
60
61       • For bash users, autojump keeps  track  of  directories  by  modifying
62         $PROMPT_COMMAND.  Do not overwrite $PROMPT_COMMAND:
63
64                export PROMPT_COMMAND="history -a"
65
66         Instead append to the end of the existing $PROMPT_COMMAND:
67
68                export PROMPT_COMMAND="${PROMPT_COMMAND:+$PROMPT_COMMAND ;} history -a"
69
70   REPORTING BUGS
71       For any questions or issues please visit:
72
73              https://github.com/wting/autojump/issues
74
75   AUTHORS
76       autojump  was  originally written by Joël Schaerer, and currently main‐
77       tained by William Ting.  More contributors can be found in AUTHORS.
78
79   COPYRIGHT
80       Copyright © 2016 Free Software Foundation, Inc. License GPLv3+: GNU GPL
81       version  3  or  later <http://gnu.org/licenses/gpl.html>.  This is free
82       software: you are free to change and redistribute it.  There is NO WAR‐
83       RANTY, to the extent permitted by law.
84
85
86
87release-v22.5.3                   2023-07-19                       autojump(1)