.png)
2 hours ago
3
A Neovim plugin for displaying inline unified diffs directly in your buffer.
- Inline Diffs: View git diffs directly in your buffer, without needing a separate window.
- File Tree Explorer: A file tree explorer is displayed, showing all files that have been changed.
- Git Gutter Signs: Gutter signs are used to indicate added, modified, and deleted lines.
- Customizable: Configure the signs, highlights, and line symbols to your liking.
- Auto-refresh: The diff view automatically refreshes as you make changes to the buffer.
- Neovim >= 0.5.0
- Git
- A Nerd Font installed and configured in your terminal/GUI is required to display file icons correctly in the file tree.
You can install unified.nvim using your favorite plugin manager.
{
'axkirillov/unified.nvim',
opts = {
-- your configuration comes here
}
}
use {
'axkirillov/unified.nvim',
config = function()
require('unified').setup({
-- your configuration comes here
})
end
}
You can configure unified.nvim by passing a table to the setup() function. Here are the default settings:
require('unified').setup({
signs = {
add = "│",
delete = "│",
change = "│",
},
highlights = {
add = "DiffAdd",
delete = "DiffDelete",
change = "DiffChange",
},
line_symbols = {
add = "+",
delete = "-",
change = "~",
},
auto_refresh = true, -- Whether to automatically refresh diff when buffer changes
})
- Open a file in a git repository.
- Make some changes to the file.
- Run the command :Unified to display the diff against HEAD and open the file tree.
- To close the diff view and file tree, run :Unified again.
- To show the diff against a specific commit, run :Unified <commit_ref>, for example :Unified HEAD~1.
When the file tree is open, you can use the following keymaps:
- j/k: Move the cursor down/up. The file under the cursor will be opened in the main window, displaying its diff.
- q: Close the file tree window.
- R: Refresh the file tree.
- ?: Show a help dialog.
The file tree displays the Git status of each file:
- M: Modified
- A: Added
- D: Deleted
- R: Renamed
- C: Copied
- ?: Untracked
- :Unified: Toggles the diff view. If closed, it shows the diff against HEAD. If open, it closes the view.
- :Unified <commit_ref>: Shows the diff against the specified commit reference (e.g., a commit hash, branch name, or tag) and opens the file tree for that range.
- :Unified reset: Removes all unified diff highlights and signs from the current buffer and closes the file tree window if it is open.
To run the automated tests:
MIT
