#directory #jump #utilities #quickly #tool #zoxide #autojump

nightly app jumpy

A full-featured replacement jump utilities like Zoxide or z

2 unstable releases

0.4.3 May 16, 2024
0.3.6 Sep 29, 2022

#2720 in Command line utilities

Download history 17/week @ 2024-07-26 1/week @ 2024-08-02 5/week @ 2024-09-20 1/week @ 2024-09-27

137 downloads per month

Apache-2.0

16KB
400 lines

Jumpy

Jumpy is a tool that allows to quickly jump to one of the directory you've visited in the past.

It is heavily inspired by Zoxide but is more lightweight and a lot faster.

In its current version it is mostly intended for my personal use, if I find to work well enough I'll improve the documentation and add new features.

Updates can be found in the changelog or in the releases.

Setup

For ZSH shells:

function z() {
    local result=$(jumpy query "$1" --checked --after "$PWD")

    if [[ -n $result ]]; then
        export __JUMPY_DONT_REGISTER=1
        cd "$result"
        export __JUMPY_DONT_REGISTER=0
    fi
}

function jumpy_handler() {
    if (( $__JUMPY_DONT_REGISTER )); then
        return
    fi

    emulate -L zsh
    jumpy inc "$PWD"
}

chpwd_functions=(${chpwd_functions[@]} "jumpy_handler")

This will allow Jumpy to register each change of directory to add them to its database.

To perform a query and jump to it, just use z <query>.

Usage

# Get the most relevant directory from a query
jumpy query <terms>

# Add a new directory to the database, or increment its score
jumpy add <terms>

# List all registered directories, sorted by score
jumpy list

# Clear the database
jumpy clear

Dependencies

~1–12MB
~77K SLoC