https://github.com/brianhuster/unnest.nvim
https://github.com/brianhuster/unnest.nvim
Last synced: 12 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/brianhuster/unnest.nvim
- Owner: brianhuster
- License: apache-2.0
- Created: 2025-07-29T19:10:39.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-30T03:53:40.000Z (12 months ago)
- Last Synced: 2025-07-30T05:44:16.399Z (12 months ago)
- Language: Lua
- Size: 13.7 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# unnest.nvim
Unnest your nested Neovim sessions.
## Introduction
Imagine that you are in a terminal buffer in Nvim, and you run a command that
opens a new Nvim instance (e.g., `git commit`). Now you have a Neovim session
running inside another Neovim session. This can be confusing and inefficient.
`unnest.nvim` solves this by detecting when it's being run in a nested
session, then it will instruct the parent Neovim instance to open files in a
in the parent Neovim instance.
## Features
- Minimal : just about 100 LOC
- Simple to install and use : no configuration, no `setup()` is required.
- Powerful
- You use commands like `git commit`, `git rebase -i`, `git mergetool` in Nvim without any other plugins (as long as you set `git mergetool` to use Nvim)
- You can integrate external file explorers like [FZF](https://github.com/junegunn/fzf), [Yazi](https://github.com/sxyazi/yazi), etc with Nvim
## Installation
Require Nvim 0.11 or later.
You can install `unnest.nvim` using any plugin manager that supports `git`, like [lazy.nvim](https://github.com/folke/lazy.nvim), [vim-plug](https://github.com/junegunn/vim-plug), etc. See the document of your plugin manager for how to install a plugin with them.
Nvim 0.12 has a built-in plugin manager, so you can also install `unnest.nvim` using
```lua
vim.pack.add { "https://github.com/brianhuster/unnest.nvim" }
```
## Usage
NOTE: there are some other plugins that do similar thing, like [flatten.nvim](https://github.com/willothy/flatten.nvim), [nvim-unception](https://github.com/samjwill/nvim-unception). Please make sure you have removed or disabled them before installing this plugin, because they can conflict with each other.
See [`:h unnest`](./doc/unnest.txt) for more details.