readme.md

Jumping

Assign custom aliases to directories and quickly jump to them from anywhere.

Installation

npm i -g jumping

Put the following in your ~/.bashrc or ~/.zshrc file:

j(){
	local dir
	dir="$(jumping --get "$1")"
	[[ -d "$dir" ]] && cd "$dir"
}

d(){
	jumping --set "$@"
}

o(){
	local dir
	dir="$(jumping --get "$1")"
	[[ -d "$dir" ]] && open "$dir" && exit
}

You can choose names other than j and d, but this document will assume you're using the same names.

Usage

d <alias> # defines an alias at the current working directory
j <alias> # jumps to the directory associated with an alias
o <alias> # opens the directory associated with an alias and closes the terminal window
jumping # lists all aliases

Guide

When you're in a directory and you realize you might want to access it later, just run d <alias>. For example, if I'm in ~/Desktop/repositories/fuzzyhome, I might make an alias rf:

d rf

Later, when I want to change to the ~/Desktop/repositories/fuzzyhome directory, I can jump to it from anywhere with:

j rf

Or, if I'd rather just open the directory with Finder and close the terminal window, I can do:

o rf

This works well with hotkey daemons such as skhd. If I want to navigate to a folder in Finder, I simply open a terminal with cmd + return per my skhd hotkey:

cmd - return : open -a Terminal ~/Desktop

Then I type o rf, and the relevant finder window opens while the terminal closes.

Extras

I prefer j with no arguments to fuzzy find files recursively.

To do this, install:

brew install fd fzy

And add the following to your ~/.zshrc:

# jumping
j(){
	if [ $# -eq 0 ]; then
		local item
		item=$(\fd | fzy -l max)
		if [[ -f "$item" ]]; then
			cd "$(dirname "$item")"
		elif [[ -d "$item" ]]; then
			cd "$item"
		fi
	else
		local dir
		dir="$(jumping --get "$1")"
		[[ -d "$dir" ]] && cd "$dir"
	fi
}

FAQ

Why do I have to edit my ~/.bashrc or ~/.zshrc?

Programs cannot change the directory of the underlying shell. So we just use jumping to set and get our aliases, while our shell function does the actual directory changing.