yaziとは

Rust製の高速ターミナルファイルマネージャ。VS Codeのサイドバーのようにファイルをブラウズし、プレビューしながら操作できる。

インストール

brew install yazi

Nerd Font（アイコン表示に必要）

brew install --cask font-hack-nerd-font

インストール後、ターミナルのフォント設定を「Hack Nerd Font」に変更する。

  • iTerm2: Settings → Profiles → Text → Font → Hack Nerd Font

基本操作

キー 操作
j/k 上下移動
l フォルダ展開 / ファイルを開く
h 親ディレクトリに戻る
/ 検索
q 終了

設定ファイル

設定は ~/.config/yazi/ に配置する。

yazi.toml - レイアウト設定

左の親ディレクトリパネルを非表示にして、ファイル一覧+プレビューの2カラムにする:

[mgr]
ratio = [0, 1, 1]

ratio はデフォルトで [1, 4, 3]（親:一覧:プレビュー）。左を 0 にすると非表示。

keymap.toml - キーバインド

# Ctrl+OでFinderで表示
[[mgr.prepend_keymap]]
on   = "<C-o>"
run  = "shell -- open -R %h"
desc = "Finderで表示"

# Escで終了
[[mgr.prepend_keymap]]
on   = "<Esc>"
run  = "quit"
desc = "終了"

シェルコマンド内のファイル参照は %h（ホバー中のファイルパス）を使う。

theme.toml - テーマ設定

ダーク背景のターミナルで文字が見づらい場合はテーマを設定する。Catppuccin Mochaベースの例:

[manager]
cwd = { fg = "#89b4fa", bold = true }
hovered = { reversed = true }

[filetype]
rules = [
  { name = "*/", fg = "#89b4fa", bold = true },
  { name = "*", fg = "#cdd6f4" },
]

プレビューのシンタックスハイライト

プレビューペインの色は theme.toml の [mgr] セクションで .tmTheme ファイルを指定する。yazi.toml や [preview] セクションではない点に注意。

# tmThemeファイルをダウンロード
curl -sL "https://raw.githubusercontent.com/catppuccin/bat/main/themes/Catppuccin%20Mocha.tmTheme" \
  -o ~/.config/yazi/Catppuccin-Mocha.tmTheme

# theme.toml
[mgr]
syntect_theme = "~/.config/yazi/Catppuccin-Mocha.tmTheme"

よくあるハマりポイント:

  • yazi.toml の [preview] に書いても効かない
  • テーマ名（"Catppuccin Mocha" 等）を直接指定しても効かない。.tmTheme ファイルのパスが必要
  • flavorを使っている場合はflavorの tmtheme.xml が優先され、この設定は無視される

注意点

  • yaziはファイルマネージャであり、エディタ機能はない。ファイルを開くと $EDITOR（vim等）が起動する
  • 独自の折りたたみロジック（特定条件でディレクトリを1行にまとめる等）は実装できない。そのような機能が必要な場合は専用ツールと併用する