yazi.nvim
A Neovim plugin that integrates the yazi terminal file manager as a floating window for seamless file navigation and management.
What is yazi.nvim?
yazi.nvim is a Neovim plugin that integrates the yazi terminal file manager as a floating window within Neovim. It allows developers to browse, select, and manage files directly from the editor, synchronizing file operations with open buffers and LSP servers. The plugin enhances productivity by providing a fast, visual file navigation interface without switching contexts.
Neovim users who prefer terminal-based file managers and want a seamless, integrated file browsing experience within their editor. It’s particularly useful for developers who frequently navigate complex project directories and value keyboard-driven workflows.
Developers choose yazi.nvim for its tight integration with Neovim, offering real-time buffer synchronization, customizable keybindings, and compatibility with popular Neovim plugins like telescope and fzf-lua. Its floating window design and visual feedback make file management intuitive and efficient.
Overview
A Neovim Plugin for the yazi terminal file manager
Use Cases
Best For
- Navigating large project directories quickly within Neovim
- Managing files with visual feedback and buffer synchronization
- Integrating terminal file management into a keyboard-driven Neovim workflow
- Searching and replacing across directories using telescope or fzf-lua
- Opening files as splits, tabs, or quickfix items from a file manager
- Customizing file management keybindings and plugin integrations
Not Ideal For
- Users who prefer graphical file managers or mouse-driven interfaces over terminal-based tools
- Developers on older Windows versions (pre-Windows 11) due to compatibility limitations
- Teams seeking a simple, lightweight file picker without the overhead of a full file manager integration
- Projects that rely on editors other than Neovim, as this plugin is Neovim-specific
Pros & Cons
Pros
Embeds yazi as a floating window with visible splits represented as tabs, allowing intuitive navigation without leaving the editor. Evidence from README: 'Open yazi in a floating window. All visible splits are opened as yazi tabs.'
Automatically syncs renamed, moved, or deleted files with open Neovim buffers and LSP servers, preventing issues with outdated files. README confirms: 'Files that are renamed, moved, or deleted in yazi are kept in sync with open buffers in Neovim' and LSP support.
Integrates with popular Neovim tools like telescope.nvim, fzf-lua.nvim, and grug-far.nvim for enhanced searching and replacing, extending functionality beyond basic file management. Listed in features section.
Offers fully customizable keymaps and hooks for actions like opening splits and managing files, allowing tailored setups. README includes extensive configuration options and examples.
Cons
Requires installing and maintaining yazi separately, plus tools like realpath or grealpath for features like copying relative paths, adding setup complexity and platform-specific hurdles. README notes these requirements.
Only supports Windows 11 or higher, excluding users on older Windows versions and limiting accessibility. Evidence: README states 'if on Windows, the minimum supported version is Windows 11.'
Advanced setup involves numerous options, hooks, and manual dependency management without package managers, which can be overwhelming and error-prone for users less familiar with Lua or Neovim. README discusses issues like #306 for non-lazy.nvim users.
Frequently Asked Questions
Related Projects
nvim-tree.luaA file explorer tree for neovim written in lua
oil.nvimNeovim file explorer: edit your filesystem like a buffer
neo-tree.nvimNeovim plugin to manage the file system and other tree like structures.
chadtreeFile manager for Neovim. Better than NERDTree.
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.