osfeed.dev
Projects/lewis6991 / gitsigns.nvim

gitsigns.nvim

Git change signs and hunk actions for Neovim

Get it on GitHub
Unclaimed

Written by @iluxav from the project's code and releases, not by its maintainers. Last updated for v2.1.0 (2026-03-26), so it may lag behind newer releases.

Are you @lewis6991?Claim it, and your coding agent keeps it current with each release
v2.1.0 · 13 things you can do 8 changes to know before upgrading
Follow GitHub

See Git changes beside your Neovim buffer, stage or reset hunks, and inspect line history.

What you can do with gitsigns.nvim

See added, changed and deleted lines beside your buffer.

1 other tool for: See Git changes
Present at v0.5
Good to know

Git repositories; buffers over the default 40,000-line limit are not attached.

Stage or reset individual hunks and selected lines without leaving Neovim.

Present at v0.5

Navigate, select and preview changed hunks with word-level differences.

Present at v0.5
Good to know

-

Inspect the author and commit for a line in a popup or virtual text.

Present at v0.5
Good to know

Current-line virtual text is opt-in.

Compare your buffer with the index or a chosen Git revision.

Present at v0.5
Good to know

-

Browse changed hunks in a quickfix or location list.

Present at v0.5
Good to know

-

Show the branch and added, changed and removed line counts in your statusline.

Present at v0.5
Good to know

Requires statusline configuration.

Inspect Git changes in detached working trees.

Present at v0.5
Good to know

Requires appropriate worktree configuration where automatic discovery is insufficient.

Show all 13

Preview the current hunk inline in your buffer.

Since v0.6
Good to know

-

Distinguish staged changes and navigate or preview their hunks.

Since v0.7

Inspect blame for the whole buffer and reblame at a commit’s parent.

Since v1.0.0
Good to know

-

Open a Git commit in a split or a new tab.

Since v2.0.0
Good to know

-

Render Git change signs in a custom Neovim status column.

Since v2.0.0
Good to know

Requires a status-column configuration calling `require('gitsigns').statuscolumn()`.

Before you upgrade gitsigns.nvim

Newest first
Show 5 older
Removed 1

See change signs for files managed by yadm.

Requires yadm and opt-in configuration.

Removedv0.5 → v1.0.0
gitsigns.nvim release history 11
v2.1.0

Include untracked files when browsing repository changes in quickfix.

Details

`setqflist` includes untracked files when enabled. Fixes renamed paths, manual attachment, blame navigation and fold preservation.

Install v2.1.0; tagged README requires Neovim >= 0.9.0 and a recent Git.

Behavior changed: Browse changed hunks in a quickfix or location list.Now works: See added, changed and deleted lines beside your bu…Behavior changed: Browse changed hunks in a quickfix or location list.Now works: Compare your buffer with the index or a chosen Git…Now works: Inspect blame for the whole buffer and reblame at a…Now works: Stage or reset individual hunks and selected lines…Now works: Show the branch and added, changed and removed line…Now works: Render Git change signs in a custom Neovim status c…

Seeded by @iluxav with Codex

Read the evidence
v2.0.0

View a Git commit in a split or a tab from Neovim.

Details

Adds `show_commit()` and automatic setup. Custom sign highlight names are removed, and popup borders follow Neovim’s `winborder`.

Install v2.0.0; tagged README requires Neovim >= 0.9.0 and Git. Release testing targets Neovim 0.11.

Added: Open a Git commit in a split or a new tab.Behavior changedAction requiredBehavior changedBehavior changed: Navigate, select and preview changed hunks with wor…Now works: See added, changed and deleted lines beside your bu…Now works: Inspect the author and commit for a line in a popup…Now works: Preview the current hunk inline in your buffer.Now works: Compare your buffer with the index or a chosen Git…Added / inferred: Render Git change signs in a custom Neovim status c…

Seeded by @iluxav with Codex

Read the evidence
v1.0.2

Unstage a staged hunk using the same hunk action.

Details

Corrects `stage_hunk` on staged hunks and `change_base` with an empty base.

Install v1.0.2; requires Neovim >= 0.9.0 and Git.

Now works: Stage or reset individual hunks and selected lines…Now works: Compare your buffer with the index or a chosen Git…

Seeded by @iluxav with Codex

Read the evidence
v1.0.1

Use blame popup menu shortcuts reliably.

Details

Corrects blame popup shortcut mappings and last-line current-line blame.

Install v1.0.1; requires Neovim >= 0.9.0 and Git.

Now works: Inspect blame for the whole buffer and reblame at a…Now works: Inspect the author and commit for a line in a popup…

Seeded by @iluxav with Codex

Read the evidence
v1.0.0

Inspect blame for the whole buffer and revisit a commit’s parent.

Details

Adds `:Gitsigns blame`, enables staged signs by default and removes built-in yadm support and legacy blame formatter options.

Install v1.0.0; requires Neovim >= 0.9.0 and Git.

Added: Inspect blame for the whole buffer and reblame at a…Behavior changed: Distinguish staged changes and navigate or preview…Removed: See change signs for files managed by yadm.Action requiredBehavior changed: Inspect the author and commit for a line in a popup…Action requiredAction requiredAction requiredAction requiredNow works: Stage or reset individual hunks and selected lines…Now works: Browse changed hunks in a quickfix or location list.Now works: Inspect Git changes in detached working trees.Action required / inferred

Seeded by @iluxav with Codex

Read the evidence
v0.9.0

Attach Gitsigns correctly to files in Git worktrees.

Details

Fixes worktree attachment and untracked-file comparisons with custom bases. Setup becomes synchronous and Neovim 0.8 support is dropped.

Install v0.9.0; requires Neovim >= 0.9.0 and Git.

Now works: Inspect Git changes in detached working trees.Now works: Compare your buffer with the index or a chosen Git…Now works: Inspect the author and commit for a line in a popup…Action requiredBehavior changed

Seeded by @iluxav with Codex

Read the evidence
v0.8.1

Reset hunks while respecting the file’s end-of-line state.

Details

Fixes end-of-line handling when resetting hunks and the yadm tracked-file check.

Install v0.8.1; requires Neovim >= 0.8.0 and Git.

Now works: Stage or reset individual hunks and selected lines…Now works: See change signs for files managed by yadm.

Seeded by @iluxav with Codex

Read the evidence
v0.8.0

Choose a revision and extra Git options when inspecting line blame.

Details

Adds revision-aware blame and `nav_hunk()`; untracked files no longer attach by default and built-in yadm support is deprecated.

Install v0.8.0; requires Neovim >= 0.8.0 and Git.

Behavior changed: Inspect the author and commit for a line in a popup…Behavior changed: See added, changed and deleted lines beside your bu…Behavior changed: Navigate, select and preview changed hunks with wor…Behavior changed: Preview the current hunk inline in your buffer.Deprecated: See change signs for files managed by yadm.Now works: Stage or reset individual hunks and selected lines…Now works: Browse changed hunks in a quickfix or location list.

Seeded by @iluxav with Codex

Read the evidence
v0.7

Distinguish staged changes and navigate or preview their hunks.

Details

Adds staged signs and staged-hunk navigation/preview, and requires Neovim 0.8. Removed keymap configuration must move to `on_attach`.

Install v0.7; requires Neovim >= 0.8.0 and Git.

Added: Distinguish staged changes and navigate or preview…Action requiredAction required / inferredAction requiredBehavior changed / inferred: See added, changed and deleted lines beside your bu…Now works: Stage or reset individual hunks and selected lines…Behavior changed: Compare your buffer with the index or a chosen Git…Behavior changed: Navigate, select and preview changed hunks with wor…

Seeded by @iluxav with Codex

Read the evidence
v0.6

Preview a changed hunk inline in the buffer.

Details

Adds `preview_hunk_inline()`, distinct untracked-file signs and revision completion; removes legacy configuration fields.

Install v0.6; requires Neovim >= 0.7.0 and Git.

Added: Preview the current hunk inline in your buffer.Behavior changed: See added, changed and deleted lines beside your bu…Behavior changed: Show the branch and added, changed and removed line…Action requiredAction requiredAction required

Seeded by @iluxav with Codex

Read the evidence
v0.5
Starting point

Stage selected changes from inside a Neovim buffer.

Details

Bootstrap of capabilities available before the ten-release window: Git signs, hunk actions, blame, revision comparison and change lists.

Install v0.5 with a Neovim plugin manager; Neovim >= 0.5.0 and Git are required.

Added: See added, changed and deleted lines beside your bu…Added: Stage or reset individual hunks and selected lines…Added: Navigate, select and preview changed hunks with wor…Added: Inspect the author and commit for a line in a popup…Added: Compare your buffer with the index or a chosen Git…Added: Browse changed hunks in a quickfix or location list.Added: Show the branch and added, changed and removed line…Added: Inspect Git changes in detached working trees.Added: See change signs for files managed by yadm.

Seeded by @iluxav with Codex

Read the evidence