Skip to content

Yazi

Yazi is a modern and intuitive file manager for the terminal.

Installation

Terminal window
# macOS (using Homebrew)
brew install yazi
# Arch Linux
pacman -S yazi
# Using Cargo (Rust package manager)
cargo install yazi

Basic Navigation

KeybindingDescription
h, j, k, lNavigate left, down, up, right
H, LGo to parent/child directory
g gGo to the top
GGo to the bottom
Alt+j/kScroll preview down/up
Ctrl+d/uScroll down/up half-page
Ctrl+f/bScroll down/up full-page

File Operations

KeybindingDescription
SpaceSelect/deselect current file
vToggle visual mode
VSelect all files
Ctrl+aSelect all files
cCopy selected files
xCut selected files
pPaste files
yCopy selected file path
YCopy selected file name
dMove to trash
DPermanently delete
:Enter command mode

Search & Filter

KeybindingDescription
/Search in current directory
n, NGo to next/previous match
fFilter files by name
FReset filters
zToggle hidden files

Tabs & Windows

KeybindingDescription
Ctrl+tOpen new tab
Ctrl+wClose current tab
Tab, Shift+TabGo to next/previous tab
Alt+1-9Go to tab 1-9

File Previews

KeybindingDescription
iToggle preview window
oOpen file with default application
EnterOpen file/directory
eOpen in editor (neovim)

Marks & Bookmarks

KeybindingDescription
m + [a-zA-Z]Create bookmark with letter
' + [a-zA-Z]Jump to bookmark

Configuration

Configuration file is located at ~/.config/yazi/yazi.toml

Common Commands

CommandDescription
:qQuit
:helpShow help
:mkdir [name]Create new directory
:touch [name]Create new file
:chmod [mode]Change file permissions
:cd [path]Change directory
:bulk [cmd]Run command on selected files

Tips for macOS

  • Integrate with Homebrew by adding the preview plugin:

    Terminal window
    brew install bat fd ripgrep fzf ueberzug
  • Add to your .zshrc for quick access:

    Terminal window
    alias y='yazi'
  • Configure Yazi to use Berkeley Mono in your config file:

    [style]
    font_family = "Berkeley Mono"

Custom Keybindings

Add to ~/.config/yazi/keymap.toml:

[manager]
keymap = [
# Custom keybindings go here
{ on = ["e"], exec = "shell 'nvim $file'", desc = "Edit with Neovim" },
]

This cheatsheet covers the most essential commands and features of Yazi. You can always access the built-in help by pressing :help while in Yazi.