autojump(1)

💅 autojump — a faster way to navigate your filesystem

okay so this is the man page for autojump, and bestie, it's literally gonna change how you move around your filesystem. no cap.

---

✨ NAME ✨

autojump — a faster way to navigate your filesystem

---

🦋 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. that's it. that's the whole magic. it's basically a little stalker for your folders (affectionate).

⚠️ real talk though: directories must be visited first before they can be jumped to. it can't jump somewhere it's never seen you go. so like, go there once, be seen, and then it's in the database. main character energy requires an entrance. 💅

---

🎀 USAGE 🎀

j is a convenience wrapper function around autojump. any option that can be used with autojump can be used with j and vice versa. they're basically twins. iconic.

• 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. lowkey the best hack fr.

jc bar

• open a 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. same energy, different result.

jo music

opening a file manager to a child directory is also supported, and yes it slaps:

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. make sense? number go big, folder get picked. ✨

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. see? the w matched the work path. the way that works 😭👑

for more options refer to help:

autojump --help

---

💀 KNOWN ISSUES 💀

• autojump does not support directories that begin with -. yeah. it just doesn't. don't fight it.
• 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:

export PROMPT_COMMAND="${PROMPT_COMMAND:+$PROMPT_COMMAND ;} history -a"

🙈 this one matters, bestie. if you clobber $PROMPT_COMMAND you're basically ghosting autojump and it will not be tracking your moves anymore.

---

🫶 REPORTING BUGS 🫶

for any questions or issues please visit:

https://github.com/wting/autojump/issues

come rant, come ask, come report the weird thing it did. we're here for it.

---

👑 AUTHORS 👑

autojump was originally written by Joël Schaerer, and currently maintained by William Ting. more contributors can be found in AUTHORS. legends, all of them. 🌈

---

🌸 COPYRIGHT 🌸

Copyright © 2016 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. and when they say no warranty they mean it like, capital-letters NO WARRANTY. the drama of it all.

---

and that's the whole page! 💖 this was autojump(1), from release-v22.5.3, dated 2018-09-09 — go jump somewhere cute, you've earned it 🎀✨