wd (warp directory) lets you jump to custom directories in zsh, without using
cd seems inefficient when the folder is frequently visited or has a long path.
- Add warp point to current working directory:
wd add foo
If a warp point with the same name exists, use
wd add foo --force to overwrite it.
Note: a warp point cannot contain colons, or consist of only spaces and dots.
The first will conflict in how
wd stores the warp points, and the second will conflict with other features, as below.
You can omit point name to automatically use the current directory's name instead.
- From any directory, warp to
- You can also warp to a directory within
foo, with autocompletion:
wd foo some/inner/path
- You can warp back to previous directory and higher, with this dot syntax:
wd .. wd ...
This is a wrapper for the zsh's
You might need to add
setopt AUTO_PUSHD to your
.zshrc if you are not using oh-my-zsh.
- Remove warp point:
wd rm foo
You can omit point name to use the current directory's name instead.
- List all warp points (stored in
- List files in given warp point:
wd ls foo
- Show path of given warp point:
wd path foo
- List warp points to current directory, or optionally, path to given warp point:
- Remove warp points to non-existent directories.
wd clean --force to not be prompted with confirmation.
- Print usage info:
The usage will be printed also if you call
wd with no command
- Print the running version of
- Specifically set the config file (default being
~/.warprc), which is useful for testing:
wd --config ./file <command>
exitwith return code after running. This is not default, as it will exit your terminal, though required for testing/debugging.
wd --debug <command>
- Silence all output:
wd --quiet <command>