Yazi

Yazi file manager config — layout, openers, bat previews, keymap, plugins, flavors, and the Neovim bridge.

Yazi is a terminal file manager. It is the default way to browse files here: shell keybindings, aliases, and a kitty shortcut all open it, and it hands files to Neovim.

yazi.toml

The only template in the directory. The one OS condition is the open opener: macOS uses open, everything else uses xdg-open.

[mgr]
ratio = [0, 2, 6]

[opener]
play = [
	{ run = "mpv %s", orphan = true, for = "unix" },
]
edit = [
	{ run = 'yazi-nvim-open %s', block = true, for = "unix" },
]
open = [
	{ run = "{{ if eq .chezmoi.os "darwin" }}open{{ else }}xdg-open{{ end }} %s1", desc = "Open" },
]

[open]
prepend_rules = [
	{ url = "*.{md,markdown}", use = [ "fry", "edit", "open" ] },
]

[[plugin.prepend_previewers]]
mime = "text/*"
run = 'piper -- bat -p --color=always --terminal-width=$w "$1"'

[[plugin.prepend_previewers]]
mime = "application/{mbox,javascript,wine-extension-ini}"
run = 'piper -- bat -p --color=always --terminal-width=$w "$1"'

Keymap

All bindings in keymap.toml are [[mgr.prepend_keymap]] entries, so they take priority over yazi’s defaults and leave the rest of the default keymap intact.

Navigation

$GHQ_ROOT is ~/Code, exported in dot_config/fish/conf.d/10-env.fish. The g m bindings need the SFTP services in vfs.toml, which are commented out (see vfs.toml).

Finding and opening

The tv plugin shells out to television, which is not in packages.yaml.

Files and session

In the shell opened by Shift+Tab, the q function (fish, bash, zsh) runs ya emit quit when $YAZI_ID is set, then exits. That closes the parent yazi too instead of returning to it.

Plugins

package.toml pins every plugin to a commit and hash. ~/.config/yazi/plugins/** is in .chezmoiignore.tmpl, so chezmoi never manages the installed code. The post-apply script reinstalls from the manifest:

#!/bin/sh
# package.toml hash: {{ include "dot_config/yazi/package.toml" | sha256sum }}
set -eu
command -v ya >/dev/null 2>&1 || exit 0
[ -f "${XDG_CONFIG_HOME:-$HOME/.config}/yazi/package.toml" ] || exit 0
ya pkg install

The embedded hash makes chezmoi re-run the script whenever package.toml changes.

[flavor] deps is empty: flavors ship as files in flavors/, not as packages.

init.lua

require("sshfs"):setup()
require("bunny"):setup({ hops = { ... }, desc_strategy = "path", ephemeral = true, tabs = true, notify = false, fuzzy_cmd = "fzf" })
require("git"):setup { order = 1500 }
require("no-status"):setup()

• sshfs: default setup, for mounting remote hosts over SSHFS.
• git: git status signs in the file list, ordered at 1500 in the linemode.
• no-status: removes the status bar.
• bunny: bookmark “hops”, with ephemeral hops and tab hops on, no notification after hopping, fzf for fuzzy search, and the path as the label when a hop has no desc.

Theme and flavors

[flavor]
light = "cyberdream"
dark = "cyberdream"
use = "cyberdream"

Cyberdream is active in both light and dark mode. Three flavors ship in flavors/:

To switch, change use (and light/dark) in theme.toml to ii-auto or noctalia.

Icons

theme.toml also carries a large [icon] table:

• prepend_dirs: Nerd Font icons for named directories: Applications, Code, Desktop, Developer, github.com, prdlk, wltbs, Shared, Templates, env, go, js, dart, py, rs, tex, md, docs, prad.codes.
• files and exts: several hundred filename and extension rules, from dotfiles like .gitignore and .zshrc to formats like kicad_pcb and wrangler.toml. Each rule sets a Nerd Font glyph and a foreground color from the Catppuccin Mocha palette (#a6e3a1, #f38ba8, #89b4fa, #cba6f7, #fab387, …).

Glyphs need a Nerd Font. The terminal uses VictorMono Nerd Font (see Terminal).

vfs.toml

Every line is commented out. The file sketches three SFTP services (gdrive-personal, gdrive-sonr, gdrive-hyperauth) on local ports, meant to be served by a local SFTP bridge to Google Drive. Until they are uncommented and the bridge is running, the g m bindings have nothing to connect to.

Neovim bridge: yazi-nvim-open

~/.local/bin/yazi-nvim-open [vsplit|split|tabedit] file... backs the edit opener and the Ctrl+v/Ctrl+x bindings. It lives on PATH because yazi does not expand $HOME in opener commands.

Set YAZI_OPEN_TRACE to a file path to log each call’s $NVIM, mode, and arguments.

Launching yazi

tmux sets allow-passthrough on so yazi’s kitty-protocol image previews work inside tmux. Kitty’s tab bar and the tmux window-name map show a folder icon for yazi. See aliases and fish for the shell side.