nvim/lua/plugins/yazi.lua

--- Yazi as the default file manager (full neo-tree replacement)
---@type LazySpec
return {
  {
    "mikavilpas/yazi.nvim",
    version = "*", -- latest stable release
    event = "VeryLazy",
    dependencies = {
      { "nvim-lua/plenary.nvim", lazy = true },
    },
    keys = {
      {
        "<leader>-",
        mode = { "n", "v" },
        "<cmd>Yazi<cr>",
        desc = "Open yazi at the current file",
      },
      {
        "<leader>cw",
        "<cmd>Yazi cwd<cr>",
        desc = "Open yazi in nvim's working directory",
      },
      {
        -- replaces AstroNvim's <Leader>o "Toggle Explorer Focus" (neo-tree)
        "<leader>o",
        "<cmd>Yazi<cr>",
        desc = "Open Explorer (yazi at current file)",
      },
      {
        "<C-e>",
        mode = { "n", "v", "t" },
        function()
          -- true toggle: if a yazi window is already open, quit it instead
          -- of nesting a second instance (yazi.nvim's toggle() always spawns)
          for _, win in ipairs(vim.api.nvim_list_wins()) do
            local buf = vim.api.nvim_win_get_buf(win)
            if vim.bo[buf].filetype == "yazi" then
              -- send `q` to the yazi process so it exits gracefully and
              -- saves its state for the next resume
              vim.api.nvim_chan_send(vim.bo[buf].channel, "q")
              return
            end
          end
          vim.cmd "Yazi toggle"
        end,
        desc = "Toggle yazi (resume last session)",
      },
    },
    ---@type YaziConfig | {}
    opts = {
      -- yazi replaces netrw/neo-tree when opening directories (nvim .)
      open_for_directories = true,
      -- open visible splits as yazi tabs for fast navigation
      open_multiple_tabs = true,
      -- occupy the whole screen instead of a floating popup
      floating_window_scaling_factor = 1,
      yazi_floating_window_border = "none",
      keymaps = {
        show_help = "<f1>",
        -- ~/.config/yazi/keymap.toml binds <C-q> to quit inside yazi;
        -- don't hijack it for the quickfix list (multi-select still goes
        -- to the quickfix list via the default yazi_opened_multiple_files)
        send_to_quickfix_list = false,
      },
      integrations = {
        -- <c-y> copy-relative-path action inside snacks pickers too
        picker_add_copy_relative_path_action = "snacks.picker",
      },
    },
    init = function()
      -- netrw is fully replaced by yazi (open_for_directories)
      vim.g.loaded_netrwPlugin = 1
    end,
  },

  -- neo-tree is fully replaced by yazi.nvim
  { "nvim-neo-tree/neo-tree.nvim", enabled = false },
}