mirror of
https://github.com/Llewellynvdm/zoxide.git
synced 2024-11-10 23:30:57 +00:00
2.9 KiB
2.9 KiB
zoxide
A cd command that learns your habits
Table of contents
Introduction
zoxide
is a blazing fast alternative to cd
, inspired by z
and z.lua
. It keeps track of the directories you use most frequently, and uses a ranking algorithm to navigate to the best match.
Examples
z foo # cd to highest ranked directory matching foo
z foo bar # cd to highest ranked directory matching foo and bar
z foo/ # can also cd into actual directories
zi foo # cd with interactive selection using fzf
zq foo # echo the best match, don't cd
za /foo # add /foo to the database
zr /foo # remove /foo from the database
Getting started
Step 1: Installing zoxide
If you have Rust, this should be as simple as:
cargo install zoxide -f
Otherwise, try the install script:
curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/ajeetdsouza/zoxide/master/install.sh | sh
If you want the interactive fuzzy selection feature, you will also need to install fzf
.
Step 2: Adding zoxide
to your shell
If you currently use z
, z.lua
, or zsh-z
, you may want to first migrate your existing database to zoxide
:
zoxide migrate /path/to/db
zsh
Add the following line to your ~/.zshrc
:
eval "$(zoxide init zsh)"
bash
Add the following line to your ~/.bashrc
:
eval "$(zoxide init bash)"
fish
Add the following line to your ~/.config/fish/config.fish
:
zoxide init fish | source
Configuration
init
flags
--no-define-aliases
: don't define extra aliases likezi
,zq
,za
, andzr
--hook <HOOK>
: change the event that adds a new entry to the database (default:prompt
)none
: never add entries - this will makezoxide
useless unless you manually configure a hookprompt
: add an entry at every promptpwd
: add an entry whenever you change directories
Environment variables
$_ZO_ECHO
:z
will print the matched directory before navigating to it$_ZO_DATA
: sets the location of the database (default:~/.zo
)$_ZO_MAXAGE
: sets the maximum total rank after which entries start getting deleted