Manager ([mgr]) Layer
The [mgr] layer handles all keybindings when the file list has focus. It is the primary layer and provides the largest set of actions.
Navigation
| Action | Arguments/Options | Description |
|---|---|---|
arrow | --up, --down, +n | Move cursor up/down by n lines |
leave | — | Go to parent directory |
enter | — | Enter the selected directory or open file |
back | — | Go back in history |
forward | — | Go forward in history |
seek | --forward, --backward | Seek through preview content |
follow | — | Follow a symbolic link to its target |
Tabs
| Action | Arguments/Options | Description |
|---|---|---|
tab_create | --cursor, --current | Create a new tab (optionally at cursor or current dir) |
tab_close | — | Close the current tab |
tab_switch | +n, --relative | Switch to tab n or move +n tabs relative |
tab_swap | +n, --relative | Swap current tab with tab at position n |
File Operations
| Action | Arguments/Options | Description |
|---|---|---|
open | --hovered | Open the selected file(s) |
yank | — | Copy (yank) selected files to the yank buffer |
unyank | — | Clear the yank buffer |
paste | — | Paste yanked files into current directory |
link | — | Create symbolic links from yanked files |
hardlink | — | Create hard links from yanked files |
remove | — | Move selected/yanked files to trash or permanently delete |
create | — | Create a new file or directory (opens input prompt) |
rename | — | Rename the current file (opens input prompt) |
copy | — | Copy filename, basename, dirname, or path to clipboard |
Selection
| Action | Arguments/Options | Description |
|---|---|---|
toggle | — | Toggle selection on the current file |
toggle_all | — | Toggle selection on all visible files |
visual_mode | — | Enter visual mode for range selection |
Search & Filter
| Action | Arguments/Options | Description |
|---|---|---|
search | — | Start a search (opens input prompt, matches filenames) |
find | --next, --prev | Jump to next/previous search result |
find_arrow | --next, --prev | Navigate between find results |
filter | — | Filter the visible file list (opens input prompt) |
sort | --by, --reverse, --dir-first | Sort files by criteria |
Display
| Action | Arguments/Options | Description |
|---|---|---|
hidden | --show, --hide | Toggle hidden file visibility |
linemode | --mode | Change the line display mode (size, mtime, etc.) |
spot | — | Toggle the file information spot panel |
Shell & System
| Action | Arguments/Options | Description |
|---|---|---|
shell | --block, --confirm, --interactive | Run a shell command |
cd | — | Change directory (opens input prompt) |
suspend | — | Suspend Yazi to background (SIGTSTP) |
quit | — | Quit Yazi |
close | — | Close current tab (quit if last tab) |
escape | — | Cancel selection, close help, or clear state |
Other
| Action | Arguments/Options | Description |
|---|---|---|
reveal | — | Reveal the current file in the system file manager |
help | — | Open the help menu |
plugin | args | Run a registered plugin |
noop | — | No operation (useful for disabling a default binding) |
Examples
Custom cd bookmarks
[manager]
prepend_keymap = [
{ on = "g h", run = "cd ~", desc = "Go home" },
{ on = "g d", run = "cd ~/Documents", desc = "Go to Documents" },
{ on = "g D", run = "cd ~/Downloads", desc = "Go to Downloads" },
{ on = "g p", run = "cd ~/projects", desc = "Go to projects" },
]
Search_do with flat view
Bind a key that emits a search action with options, then applies a filter:
[manager]
prepend_keymap = [
{ on = "f", run = "filter", desc = "Filter files" },
{ on = "F", run = "search --args='--flat'", desc = "Flat search" },
]
Disable a default key
[manager]
prepend_keymap = [
{ on = "y", run = "noop", desc = "" },
]
info
The noop action is the standard way to disable a default keybinding — override it to do nothing.