A smarter cd command that learns your most-used directories and lets you jump to them with a few keystrokes, across all major shells.
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
Install with Homebrew on macOS
brew install jump - 2
Or install with Go
go install github.com/gsamokovarov/jump@latest - 3
Add shell integration for bash or zsh
eval "$(jump shell)" - 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
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
A general-purpose command-line fuzzy finder that filters any list of input and turns shell scripts into interactive terminal selectors.
A shell history replacement that stores commands in SQLite with context like exit code and duration, with optional end-to-end encrypted sync across machines.
A cross-platform prompt theme engine that renders customizable shell prompts for PowerShell, bash, zsh, fish, and more.
A Rust shell history search that replaces Ctrl-R with a context-aware, neural-network-ranked full-screen search.
A full-text search engine library for PHP that builds indexes in SQLite, MySQL, or Redis and returns ranked document IDs.