dlyongemallo/diffview.nvim

github

git

128

5

3

2

CREATED

2024-12-28

UPDATED

2026-04-15

---

Diffview.nvim

Note: This is an actively maintained fork of sindrets/diffview.nvim with bug fixes and improvements applied. The original repository has not been updated since June 2024.

Introduction

Single tabpage interface for easily cycling through diffs for all modified files for any git rev. Review all changed files, resolve merge conflicts, and browse file history from a unified view.

Requirements

• Neovim ≥ 0.10.0 (with LuaJIT)
• nvim-web-devicons or mini.icons (optional) for file icons

Supported VCS (at least one required):

• Git ≥ 2.31.0
• Mercurial ≥ 5.4.0
• Sapling (any version; detected automatically via the Mercurial adapter)
• Jujutsu ≥ 0.38.0 (:DiffviewOpen only; file history is not yet supported)
• Perforce ≥ 2019.1 with the p4 CLI (experimental)

Installation

-- Lazy
{
    "dlyongemallo/diffview.nvim",
    version = "*",
    -- optional: lazy-load on command
    -- cmd = {
    --     "DiffviewOpen",
    --     "DiffviewToggle",
    --     "DiffviewFileHistory",
    --     "DiffviewDiffFiles",
    --     "DiffviewLog",
    -- },
}

" Plug
Plug 'dlyongemallo/diffview.nvim'

Quick Start

:DiffviewOpen              " Diff working tree against index
:DiffviewFileHistory %     " History for the current file
:DiffviewFileHistory       " History for the whole repo
:DiffviewDiffFiles a b     " Diff two arbitrary files
:DiffviewClose             " Close the current diffview

Press g? in any diffview buffer to see all available keymaps.

See USAGE.md for detailed guides on PR review, stash inspection, and committing workflows.

Features

• Diff View — Browse all changed files in a single tabpage. Stage individual hunks by editing index buffers directly.

• File History — List all commits affecting a file, directory, or line range. Filter by author, message, date range, and more.

• Merge Tool — 3-way and 4-way diff layouts for resolving conflicts, with mappings for choosing OURS/THEIRS/BASE versions.

• Staging — Stage and unstage individual files or all changes from the file panel (- / s / S / U). You can stage individual hunks by editing any buffer that represents the index (after running :DiffviewOpen with no [rev] the entries under "Changes" will have the index buffer on the left side, and the entries under "Staged changes" will have it on the right side). Once you write to an index buffer the index will be updated.

Commands

Examples:

:DiffviewOpen                      " Working tree changes
:DiffviewOpen HEAD~2               " Changes since HEAD~2
:DiffviewOpen origin/main...HEAD   " Symmetric diff (PR-style)
:DiffviewOpen -- lua/diffview      " Limit to specific paths
:DiffviewFileHistory %             " Current file history
:'<,'>DiffviewFileHistory          " History for selected lines

VCS Adapter Notes

• Jujutsu currently supports only :DiffviewOpen. The options --cached, --staged, and --imply-local are Git-only. In colocated repos, set preferred_adapter = "jj" to use the Jujutsu adapter.
• Sapling is detected automatically through the Mercurial adapter. Use hg_cmd to configure the executable (e.g. hg_cmd = { "sl" }).
• Perforce support is experimental. Requires the p4 CLI ≥ 2019.1 and the environment variables P4PORT, P4USER, P4CLIENT.

For full command documentation, see :h diffview-commands.

[!IMPORTANT]

Familiarize Yourself With :h diff-mode

This plugin builds on nvim's built-in diff mode. Make sure you're familiar with jumping between hunks (:h jumpto-diffs) and applying diff changes (:h copy-diffs).

Configuration

A minimal configuration showing commonly customised options:

require("diffview").setup({
  enhanced_diff_hl = true,
  use_icons = true,
  view = {
    default = { layout = "diff2_horizontal" },
    merge_tool = { layout = "diff3_horizontal" },
  },
  file_panel = {
    listing_style = "tree",
    win_config = { position = "left", width = 35 }, -- Use "auto" to fit content
  },
  hooks = {},   -- See :h diffview-config-hooks
  keymaps = {}, -- See :h diffview-config-keymaps
})

For the full list of options with defaults, see doc/diffview_defaults.txt or run :h diffview.defaults in Neovim.

See RECIPES.md for ready-to-use configuration snippets covering PR review, merge conflicts, file history, and more.

Companion Plugins

• diffchar.vim — VSCode-style character/word-level diff highlighting. Works out of the box.
• Telescope — Select branches or commits interactively. See RECIPES.md for setup.
• gitsigns.nvim — When installed and watch_index is enabled (the default), the file panel refreshes instantly after staging or unstaging hunks via gitsigns.
• Neogit — Git porcelain with built-in diffview integration (integrations = { diffview = true }).

See TIPS.md for setup details and known compatibility issues.

Tips and FAQ

See TIPS.md for common usage patterns, revision argument guide, LSP diagnostics in diffs, platform notes, and plugin compatibility.

Further Reading