https://github.com/Crysthamus/nvim-file-operations
Neovim plugin that adds support for file operations using LSPs.
https://github.com/Crysthamus/nvim-file-operations
Last synced: 8 days ago
JSON representation
Neovim plugin that adds support for file operations using LSPs.
- Host: GitHub
- URL: https://github.com/Crysthamus/nvim-file-operations
- Owner: Crysthamus
- License: mit
- Created: 2026-05-26T05:49:09.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-05-26T17:29:03.000Z (about 1 month ago)
- Last Synced: 2026-05-26T19:16:13.639Z (about 1 month ago)
- Language: Lua
- Size: 19.5 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-neovim - Crysthamus/nvim-file-operations - Add support for workspace file operations using built-in LSPs. (LSP)
README
# nvim-file-operations
`nvim-file-operations` is a Neovim plugin that adds support for workspace file operations using built-in [LSP](https://neovim.io/doc/user/lsp.html)s.
This plugin serves as a modern, maintained, and direct drop-in replacement for [`nvim-lsp-file-operations`](https://github.com/antosha417/nvim-lsp-file-operations).
It works by subscribing to events emitted by file managers like [`nvim-tree`](https://github.com/nvim-tree/nvim-tree.lua), [`neo-tree`](https://github.com/nvim-neo-tree/neo-tree.nvim), and [`triptych`](https://github.com/simonmclean/triptych.nvim).
## Features
- **Full Specification Support:** Implements all [`workspace.fileOperations`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#workspace_fileOperations) in the current LSP spec:
- [`workspace/willRenameFiles`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#workspace_willRenameFiles)
- [`workspace/didRenameFiles`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#workspace_didRenameFiles)
- [`workspace/willCreateFiles`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#workspace_willCreateFiles)
- [`workspace/didCreateFiles`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#workspace_didCreateFiles)
- [`workspace/willDeleteFiles`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#workspace_willDeleteFiles)
- [`workspace/didDeleteFiles`](https://microsoft.github.io/language-server-protocol/specifications/lsp/3.17/specification/#workspace_didDeleteFiles)
It also has faster startup times and better performance than `nvim-lsp-file-operations`
## Installation
### Using lazy.nvim
```lua
return {
{
"Crysthamus/nvim-file-operations",
dependencies = {
-- Uncomment whichever supported plugin(s) you use
-- "nvim-tree/nvim-tree.lua",
-- "nvim-neo-tree/neo-tree.nvim",
-- "simonmclean/triptych.nvim"
},
config = function()
require("nvim-file-operations").setup()
end,
},
}
```
Please use `branch = "compat"`, if you are using versions older than 0.11
## Setup
Initialize the plugin with the default configuration:
```lua
require("nvim-file-operations").setup()
```
To override the defaults, pass an options table:
```lua
require("nvim-file-operations").setup({
-- Select which file operations to enable
operations = {
willRenameFiles = true,
didRenameFiles = true,
willCreateFiles = true,
didCreateFiles = true,
willDeleteFiles = true,
didDeleteFiles = true,
},
-- How long to wait (in milliseconds) for LSP responses before cancelling
timeout_ms = 10000,
-- Saves modifies files after renames, moves, etc.
auto_save = false
})
```
Some LSP servers also expect to be informed about the extended client capabilities:
```lua
vim.lsp.config("*", {
capabilities = require("nvim-file-operations.config").default_capabilities(),
})
```
## API
### rename(opts)
Renames a file on disk, updates matching Neovim buffers to the new path, and notifies LSP clients.
```lua
require("nvim-file-operations").rename({
old_name = "path/to/old_file.lua", -- Optional. Defaults to active buffer.
new_name = "path/to/new_file.lua", -- Required.
})
```
### create(opts)
Creates a new file on disk, ensures parent directories exist, notifies LSP clients, and opens the file.
```lua
require("nvim-file-operations").create({
fname = "path/to/new_file.lua", -- Required.
})
```
### delete(opts)
```lua
require("nvim-file-operations").delete({
fname = "path/to/target.lua", -- Optional. Defaults to active buffer.
})
```