.\" generated with Ronn-NG/v0.10.1
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
.TH "JUMP" "1" "December 2025" ""
jump – navigate the filesystem using fuzzy directory matching\fBj\fR \fIterm\fR
.br
\fBj\fR \fIterm\fR/\fIsubterm\fR
.br
\fBj\fR \. [term]
.br
\fBjump\fR \fIcommand\fR [options]\fBJump\fR is a directory navigation tool that learns the folders you visit and lets you return to them with short, fuzzy search terms\. It integrates with your shell through the helper function \fBj\fR, which accepts only search terms – no flags, no options\. Whatever you type becomes a pattern Jump matches against its directory database\.
.P
Jump updates its scoring database automatically as you navigate\.Add Jump to your shell configuration:
.IP "" 4
.nf
eval "$(jump shell)"                 # bash / zsh
jump shell fish | source             # fish
Invoke\-Expression (&jump shell pwsh) # PowerShell
jump shell nushell | save \-\-append $nu\.config\-path # Nushell
murex\-package install https://github\.com/lmorg/murex\-module\-jump\.git # Murex
.fi
.IP "" 0
.P
Jump begins tracking directories as soon as this integration is active\.
.SH "Keybindings"
Choose an alternative helper name instead of \fBj\fR:
.IP "" 4
.nf
eval "$(jump shell \-\-bind=z)"        # bind to `z`
eval "$(jump shell \-\-bind=goto)"     # bind to `goto`
eval "$(jump shell \-\-bind=cd)"       # override `cd`
.fi
.IP "" 0
.P
Binding to \fBcd\fR makes directory changes behave like Jump searches:
.IP "" 4
.nf
cd project          # performs a fuzzy jump
cd src/app          # performs a relative jump when the path exists
.fi
.IP "" 0
.nf
j wc               # Fuzzy Jump
j web\-console      # Exact Match
j dev/soc/web      # Deep Jump
j ch site          # Multi\-Part Match
j app/             # Relative Jump
j \.                # Repo Root
j \. cable          # Based Mode
j \-                # cd \-
j \.\.               # cd \.\.
j \.\./\.\.            # cd \.\./\.\.
j                  # Reverse Jump
j Dev              # Case\-Sensitive
.fi
Fuzzy match against frequently visited directories:
.IP "" 4
.nf
j wc               # \-> /Users/genadi/Development/rails/web\-console
j console          # \-> /Users/genadi/Development/rails/web\-console
j b\-c              # \-> /Users/genadi/Development/rails/web\-console
.fi
.IP "" 0
.P
Exact matches override fuzzy scoring:
.IP "" 4
.nf
j web\-console      # \-> /Users/genadi/Development/rails/web\-console
.fi
.IP "" 0
Jump can match across multiple path components:
.IP "" 4
.nf
j ch site          # \-> /Users/genadi/Development/chaos/website
j dev/soc/web      # \-> /Users/genadi/Development/society/website
.fi
.IP "" 0
.P
Useful when many directories share similar names\.Limit fuzzy search to the current git repository root or \fB$JUMP_BASED_PATH\fR:
.IP "" 4
.nf
j \. cable          # \-> /Users/genadi/Development/rails/rails/actioncable
j \. actionview/app # \-> /Users/genadi/Development/rails/rails/actionview/app
j \.                # \-> /Users/genadi/Development/rails/rails
.fi
.IP "" 0
.P
Ideal for monorepos with repeated directory names\.If the input contains or ends with a slash, Jump checks for an existing relative path:
.IP "" 4
.nf
j actioncable/     # \-> \./actioncable
j actionpack/app   # \-> \./actionpack/app
.fi
.IP "" 0
.P
Jump also mirrors shell\-style movements:
.IP "" 4
.nf
j \-                # \-> previous directory
j \.\.               # \-> parent directory
j \.\./\.\.            # \-> grandparent directory
.fi
.IP "" 0
.P
If the path does not exist, Jump falls back to fuzzy matching\.Repeat \fBj\fR with no arguments to jump to the next\-best match:
.IP "" 4
.nf
j web              # \-> /Users/genadi/Development/society/website
j                  # \-> /Users/genadi/Development/chaos/website
.fi
.IP "" 0
Capital letters trigger case\-sensitive search:
.IP "" 4
.nf
j Dev              # \-> /Users/genadi/Development
.fi
.IP "" 0
Pins force a search term to always resolve to a specific directory:
.IP "" 4
.nf
cd /Users/genadi/development/rails
jump pin r
j r                # \-> /Users/genadi/development/rails
.fi
.IP "" 0
.P
Manage pins:
.IP "" 4
.nf
jump pins
jump unpin r
.fi
.IP "" 0
Jump maintains an internal scoring database\.
.IP "" 4
.nf
jump clean         # remove stale entries
jump forget        # forget the current directory
jump top           # show ranked directories
jump top \-\-score   # include numeric scores
jump top dev       # filter by fuzzy term
.fi
.IP "" 0
Import data from previous tools:
.IP "" 4
.nf
jump import
jump import autojump
jump import z
.fi
.IP "" 0
.P
Existing scores are preserved during import\.Jump is opinionated, and we recommend sticking with the hand\-tuned defaults that have evolved over years of use\. Still, a few settings are available when tuning the behavior is helpful\. These options are managed with \fBjump settings\fR\.
.SS "\-\-space"
Control how spaces are interpreted\.
.br
Removing spaces allows more relaxed matching:
.IP "" 4
.nf
jump settings \-\-space=ignore
.fi
.IP "" 0
.SS "\-\-preserve"
Prevent automatic cleanup of missing directories:
.IP "" 4
.nf
jump settings \-\-preserve=true
.fi
.IP "" 0
.SS "\-\-reset"
Reset all settings to defaults:
.IP "" 4
.nf
jump settings \-\-reset
.fi
.IP "" 0
Genadi Samokovarovautojump(1), z(1), pushd(1), popd(1)