Skip to main content

Quick Start

Once you've installed Yazi, start the program with:


Press q to quit and ~ to open the help menu.

Shell wrapper

We suggest using this yy shell wrapper that provides the ability to change the current working directory when exiting Yazi.

function yy() {
local tmp="$(mktemp -t "yazi-cwd.XXXXXX")"
yazi "$@" --cwd-file="$tmp"
if cwd="$(cat -- "$tmp")" && [ -n "$cwd" ] && [ "$cwd" != "$PWD" ]; then
cd -- "$cwd"
rm -f -- "$tmp"

To use it, copy the function into the configuration file of your respective shell. Then use yy instead of yazi to start.



For all keybindings, see the default keymap.toml file.

To navigate between files and directories you can use the arrow keys , , and or Vim-like keys such as h, j, k, l:

Key bindingAlternate keyAction
kMove the cursor up
jMove the cursor down
lEnter hovered directory
hLeave the current directory and into its parent

Further navigation commands can be found in the table below.

Key bindingAction
KMove the cursor up 5 lines
JMove the cursor down 5 lines
ggMove cursor to the top
GMove cursor to the bottom


To select files and directories, the following commands are available.

Key bindingAction
SpaceToggle selection of hovered file/directory
vEnter visual mode (selection mode)
VEnter visual mode (unset mode)
Ctrl + aSelect all files
Ctrl + rInverse selection of all files
EscCancel selection

File/directory operations

To interact with selected files/directories use any of the commands below.

Key bindingAction
oOpen the selected files
OOpen the selected files interactively
EnterOpen the selected files
Ctrl + EnterOpen the selected files interactively (some terminals don't support it yet)
yYank the selected files (copy)
xYank the selected files (cut)
pPaste the yanked files
PPaste the yanked files (overwrite if the destination exists)
Y or XCancel the yank state (unyank)
-Create a symbolic link to the yanked files (absolute path)
_Create a symbolic link to the yanked files (relative path)
dMove the files to the trash
DPermanently delete the files
aCreate a file or directory (ends with "/" for directories)
rRename a file or directory
;Run a shell command
:Run a shell command (block the UI until the command finishes)
.Toggle the visibility of hidden files
Ctrl + sCancel the ongoing search
zJump to a directory using zoxide
ZJump to a directory, or reveal a file using fzf

Copying paths

To copy paths, use any of the following commands below.

Observation: cd indicates pressing the c key followed by pressing the d key.

Key bindingAction
ccCopy absolute path
cdCopy the path of the parent directory
cfCopy the name of the file
cnCopy the name of the file without the extension

Filtering files/directories

Key bindingAction
fFilter the files/directories in CWD

Finding files/directories

Key bindingAction
/Forward find file/directory in CWD
?Backward find file/directory in CWD
nJump to next occurrence
NJump to previous occurrence

Searching files/directories

Key bindingAction
sSearch files by name using fd
SSearch files by content using ripgrep


To sort files/directories use the following commands.

Observation: ,a indicates pressing the , key followed by pressing the a key.

Key bindingAction
,mSort by modified time
,MSort by modified time (reverse)
,cSort by creation time
,CSort by creation time (reverse)
,eSort by file extension
,ESort by file extension (reverse)
,aSort alphabetically
,ASort alphabetically (reverse)
,nSort naturally
,NSort naturally (reverse)
,sSort by size
,SSort by size (reverse)


Check out our flavors repository, or cooking a flavor!