jump_dirs

Jump around the most used directories, based on frecency.

Inspired by rupa/z.

Installation / Basic Setup

Get a copy of jump_dirs by EITHER:

• downloading the zip from the releases and extract it wherever you want.
• cloning the whole repository and compiling the source file yourself.

If you want to start jump_dirs only for the current console, execute

.\start_jump_dirs.cmd

If you want to enable jump_dirs on every console you open, execute

.\enable_jump_dirs.cmd

P.S.: Enabling jump_dirs does not start it in the current console. You can either open a new console or execute .\start_jump_dirs.cmd.

You should now be able to use the command z.

After having started/enabled it, you will need to cd around a bit to allow jump_dirs to build up the datafile and learn your favourite directories!

P.S.: If you move the jump_dirs directory you will need to re-start/enable it in order for it to work correctly

Usage / Examples

• z foo -> cd to the most frecent directory matching foo

• z foo bar -> cd to the most frecent directory matching foo and bar in that order. (C:\bar\foo doesn't match!)

• z -c foo -> cd to the most frecent directory matching foo, restricting the search to subdirectories of the current directory

• z -e foo -> print the most frecent directory matching foo

• z -a foo -> add foo (gets converted to a fully qualified path) to the datafile without cd-ing inside of it

• z -x foo -> remove foo (gets converted to a fully qualified path) from the datafile

• z -l -> print all of the entries in the datafile with their current frecency

• z -h / z --help -> print a help message

Configuration

You can optionally set some environment variables yourself to change some default values.

• Set JUMP_DIRS_CMD to change the command name (default is z).

• Set JUMP_DIRS_DATAFILE to change the path of the datafile (default is <jump_dirs dir>\_jump_dirs_data_file).

• Set JUMP_DIRS_MAX_SCORE to change the aging velocity of the entries, lower to age faster (default is 5000)

• Set JUMP_DIRS_CODEPAGE to change the codepage to which the terminal is set on startup by jump_dirs with the command CHCP (default is 1252)

Uninstall / Disable / Stop

If you want to stop jump_dirs only for the current console, execute

.\stop_jump_dirs.cmd

If you want to disable jump_dirs on every console you open, execute

.\disable_jump_dirs.cmd

If you want to remove jump_dirs completly from your computer, disable it and then delete its directory.