explaingit

wting/autojump

Analysis updated 2026-06-24

16,907PythonAudience · developerComplexity · 2/5LicenseSetup · easy

TLDR

A shell command that learns which directories you visit most so you can jump back with a fragment of the path, like j foo.

Mindmap

mindmap
    root((autojump))
      Inputs
        Shell cd history
        Path fragments
      Outputs
        Jump to directory
        Open in file manager
      Use Cases
        Faster terminal navigation
        Jump to recent project
        Replace cd plus tab
      Tech Stack
        Python
        Bash
        Zsh
        Fish
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Jump to frequently visited directories with j projectname instead of long cd paths

USE CASE 2

Open the matching directory in Finder or Explorer using jo

USE CASE 3

Restrict jumps to child directories of the current path with jc

What is it built with?

PythonBashZshFish

How does it compare?

wting/autojumpnetworkx/networkxreddit-archive/reddit
Stars16,90716,90316,943
LanguagePythonPythonPython
Setup difficultyeasyeasyhard
Complexity2/52/54/5
Audiencedeveloperresearcherdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

After install you must source the shell hook in your rc file or jumps will not be recorded.

Free to use, modify, and share, but any redistributed version must also be released under GPL v3.

In plain English

autojump is a command-line tool that makes navigating your file system much faster by learning which directories you visit most often. Instead of typing out full directory paths every time you want to go somewhere, autojump lets you jump directly to frequently visited locations by typing just a part of the name. The tool maintains a database of every directory you visit from the command line. Once you've been somewhere before, you can jump back with j foo, where "foo" is any part of the path. It picks the directory you visit most often that matches. If you pass multiple words like j work inbox, it tries to match both terms in order, which lets you be more specific when multiple folders have similar names. There's also jc for preferring child directories of your current location, and jo to open the matching directory in your system's file manager instead of navigating there in the terminal. autojump is written in Python and integrates with bash, zsh, fish, and other shells. It works on Linux, macOS, and Windows (with some community-supported variants). You install it and add a one-liner to your shell's startup file, and from that point on it silently tracks your navigation habits in the background. You would use autojump if you spend a lot of time in the terminal and find yourself repeatedly typing long directory paths to get to the same places. It removes the friction of remembering and typing exact paths, just type a fragment and jump there instantly.

Copy-paste prompts

Prompt 1
Walk me through installing autojump on macOS with Homebrew and wiring it into my zsh config
Prompt 2
Show me how to migrate my autojump database between two machines so my jump history follows me
Prompt 3
Compare autojump with zoxide and fasd and tell me which to pick for a fresh dotfiles setup
Prompt 4
Write a fish shell function that uses autojump to cd into the most recent git repo

Frequently asked questions

What is autojump?

A shell command that learns which directories you visit most so you can jump back with a fragment of the path, like j foo.

What language is autojump written in?

Mainly Python. The stack also includes Python, Bash, Zsh.

What license does autojump use?

Free to use, modify, and share, but any redistributed version must also be released under GPL v3.

How hard is autojump to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is autojump for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub wting on gitmyhub

Verify against the repo before relying on details.