wting /autojump

A cd command that learns - easily navigate directories from the command line

★ 16,961⑂ 704👁 162⑃ 199● 515▤ 0
PythonNOASSERTIONCreated 2009-01-14
+0
日增长
16,961
stars
704
forks
162
watchers
199
prs
515
issues
0
releases

README

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.

Directories must be visited first before they can be jumped to.

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.

-   Jump To A Directory That Contains foo:

        j foo

-   Jump To A Directory That Contains foo, Preferring Child Directories:

    You can prioritize child directories over matches in the databases via

        jc foo

-   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

    Opening a file manager to a child directory is also supported:

        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. 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.

For more options refer to help:

    autojump --help

INSTALLATION
------------

 REQUIREMENTS

-   Python v2.6+ or Python v3.3+
-   Supported shells
    -   bash - first class support
    -   zsh - first class support
    -   fish - community supported
    -   tcsh - community supported
    -   clink - community supported
-   Supported platforms
    -   Linux - first class support
    -   OS X - first class support
    -   Windows - community supported
    -   BSD - community supported
-   Supported installation methods
    -   source code - first class support
    -   Debian and derivatives - first class support
    -   ArchLinux / Gentoo / openSUSE / RedHat and derivatives -
        community supported
    -   Homebrew / MacPorts - community supported

Due to limited time and resources, only "first class support" items will
be maintained by the primary committers. All "community supported" items
will be updated based on pull requests submitted by the general public.

Please continue opening issues and providing feedback for community
supported items since consolidating information helps other users
troubleshoot and submit enhancements and fixes.

 MANUAL

Grab a copy of autojump:

    git clone https://github.com/wting/autojump.git

Run the installation script and follow on screen instructions.

    cd autojump
    ./install.py or ./uninstall.py

 AUTOMATIC

 Linux

autojump is included in the following distro repositories, please use
relevant package management utilities to install (e.g. apt-get, yum,
pacman, etc):

-   Debian, Ubuntu, Linux Mint

    All Debian-derived 

Top issues

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON