Repolode
gsamokovarov

gsamokovarov/jump

A shell directory jumper that learns the directories you visit and lets you cd into them with a few fuzzy-typed characters.

Stars
1,950
Forks
65
Open issues
3
Last commit
10 days ago

What is it?

Jump is a command-line tool that hooks into your shell and records the directories you visit. Later, instead of typing a full path, you type a few fuzzy characters and Jump moves you to the directory it ranks highest for those characters.

It integrates with bash, zsh, fish, PowerShell, Nushell and Murex, and can be bound to a different key or directly to cd. Jump also handles deep paths such as dev/soc/web, multi-part matches, case-sensitive matches, and relative paths. Pins let you assign a short name to a fixed directory, and a based mode resolves names relative to the git repository root or a configured base path, which helps in monorepos with repeated directory names.

Jump can import existing history from autojump, z and zoxide, and includes commands to list ranked directories, remove stale entries and forget the current directory.

Key features

  • 01Learns visited directories and ranks them by how often and how recently you use them.
  • 02Supports fuzzy, exact, deep, multi-part and case-sensitive matching.
  • 03Works with bash, zsh, fish, PowerShell, Nushell and Murex.
  • 04Pins let you assign short names to fixed directories.
  • 05Imports history from autojump, z and zoxide.

Use cases

  • Jumping quickly between frequently used project directories in a terminal.
  • Navigating large monorepos where directory names repeat, using based mode.
  • Migrating directory history from autojump, z or zoxide.

Quick start

  1. 1

    Install with Homebrew on macOS

    brew install jump
  2. 2

    Or install with Go

    go install github.com/gsamokovarov/jump@latest
  3. 3

    Add shell integration for bash or zsh

    eval "$(jump shell)"
  4. 4

    Jump to a directory with a fuzzy match, for example j wc

    j wc

Things to know

  • Shell integration is required before the j command works.
  • The README does not describe Windows support beyond PowerShell integration.

In collections

Topics

#shell#cli#cd#directory-navigation#fuzzy-search#zsh#fish#bash#autojump#fuzzy

FAQ

What is jump?
A shell directory jumper that learns the directories you visit and lets you cd into them with a few fuzzy-typed characters. Jump is a command-line tool that hooks into your shell and records the directories you visit. Later, instead of typing a full path, you type a few fuzzy characters and Jump moves you to the directory it ranks highest for those characters.
Is jump free to use? What license does it have?
jump is open source under the MIT license. Check the license terms before using it in commercial products.
Is jump still maintained?
Actively maintained. The last commit to jump was on Oct 27, 2026.
What can I use jump for?
Jumping quickly between frequently used project directories in a terminal. Navigating large monorepos where directory names repeat, using based mode. Migrating directory history from autojump, z or zoxide.
How do I install jump?
Install with Homebrew on macOS: brew install jump Or install with Go: go install github.com/gsamokovarov/jump@latest Add shell integration for bash or zsh: eval "$(jump shell)" Jump to a directory with a fuzzy match, for example j wc: j wc
Where can I get jump?
The source code and installation instructions are on GitHub: https://github.com/gsamokovarov/jump

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects