jump

[releases]

Jump integrates with your shell and learns about your navigational habits bykeeping track of the directories you visit. It gives you the most visiteddirectory for the shortest search term you type.

Installation

Jump comes in packages for the following platforms.

Integration

Jump needs to be integrated with the shell. For bash and zsh, the linebelow needs to be in ~/.bashrc, ~/bash_profile or ~/.zshrc:

eval "$(jump shell)"

For fish shell, put the line below needs to be in ~/.config/fish/config.fish:

status --is-interactive; and source (jump shell fish | psub)

Once integrated, jump will automatically monitor directory changes and startbuilding an internal database.

But j is not my favourite letter!

This is fine, you can bind jump to z, with this:

eval "$(jump shell --bind=z)"

And now, you can use jump like z dir and it would just work! This is onlyan example, you can bind it to anything. If you are one of those persons thatlikes to type a lot with their fingers, you can do:

eval "$(jump shell --bind=goto)"

Voila! goto dir becomes a thing. The possibilities are endless!

Usage

Once integrated, jump introduces the j helper. It accepts only searchterms and as a design goal there are no arguments to j. Whatever you giveit, it's treated as search term.

Jump uses fuzzy matching to find the desired directory to jump to. Thismeans that your search terms are patterns that match the desired directoryapproximately rather than exactly. Typing 2 to 5 consecutive charactersof the directory name is all that jump needs to find it.

Regular jump

The default search behavior of jump is to fuzzy match thedirectory name of a score. The match is case insensitive.

If you visit the directory /Users/genadi/Development/rails/web-console often,you can jump to it by:

$ j wc      # or...
$ j webc    # or...
$ j console # or...
$ j b-c     # or...

Using jump is all about saving key strokes. However, if you made the effort totype a directory base name exactly, jump will try to find the exact match,rather than fuzzy search.

$ j web-console
$ pwd
/Users/genadi/Development/rails/web-console

Deep jump

Given the following directories:

/Users/genadi/Development/society/website
/Users/genadi/Development/chaos/website

Typing j site matches only the base names of the directories. The base nameof /Users/genadi/Development/society/website is website, the same as theother absolute path above. The jump above will land on the most scrored path,which is the society one, however what if we wanted to land on the chaoswebsite?

$ j ch site
$ pwd
/Users/genadi/Development/chaos/website

This instructs jump to look for a site match inside that is preceded by ach match in the parent directory. The search is normalized only on the lasttwo parts of the target paths. This will ensure a better match, because of theshorter path to fuzzy match on.

There are no depth limitations though and a jump to/Users/genadi/Development/society/website can look like:

$ j dev soc web
$ pwd
/Users/genadi/Development/society/website

In fact, every space passed to j is converted to an OS separator. The lastsearch term can be expressed as:

$ j dev/soc/web
$ pwd
/Users/genadi/Development/society/website

Reverse jump

Bad jumps happen. Sometimes we're looking for a directory that doesn't have thebest score at the moment. Let's work with the following following jump database:

/Users/genadi/Development/society/website
/Users/genadi/Development/chaos/website
/Users/genadi/Development/hack/website

Typing j web would lead to:

$ j web
$ pwd
/Users/genadi/Development/society/website

If we didn't expect this result, instead of another search term, typing jwithout any arguments will instruct jump to go the second best match.

$ j
$ pwd
/Users/genadi/Development/chaos/website

Case sensitive jump

To trigger a case-sensitive search, use a term that has a capital letter.

$ j Dev
$ pwd
/Users/genadi/Development

The jump will resolve to /Users/genadi/Development even if there is/Users/genadi/Development/dev-tools that scores better.

Is it like autojump or z?

Yes, it is! You can import your datafile from autojump or z with:

$ jump import

This will try z first then autojump, so you can even combine all theentries from both tools.

The command is safe to run on pre-existing jump database, because if an entryexist in jump already, it won't be imported and it's score will remainunchanged. You can be explicit and choose to import autojump or z with:

$ jump import autojump
$ jump import z

If you want to know more about the difference between Jump, z, and autojump,check-out this Twitter conversation.

Thanks! ��

Thank you for stopping by and showing your interest in Jump!