lewis6991/gitsigns.nvim
Gitsigns.nvim
Gitsigns.nvim is a Neovim plugin that integrates Git diff visualization, blame annotations, and hunk-based staging directly into the editor buffer. It renders add, modify, and delete indicators in the sign column for tracked files, and provides inline or popup blame annotations showing commit authorship and date for each line. The plugin operates on individual diff hunks as atomic units for staging, reverting, and navigation, all executed asynchronously via Neovim's job control API to avoid blocking the UI.
The plugin distinguishes itself by enabling hunk-level staging and resetting directly from the buffer without requiring a separate terminal or staging tool, including partial selections in visual mode. It offers hunk navigation between changes, previews of original hunk content in floating windows, and the ability to select hunks as text objects for editing operations. Gitsigns also populates Neovim's quickfix or location lists with structured hunk data for batch review, with optional integration with the Trouble plugin for displaying hunk lists.
Beyond core diff and staging capabilities, the plugin supports comparing the current buffer against any Git revision or index with optional intra-line word highlighting, and can open the current file as it existed at any specified commit in a new buffer. It integrates with fugitive revision buffers and provides buffer-local variables with counts of added, removed, and changed lines for status line display. The plugin is configured through Neovim's Lua API and is available via popular plugin managers.
Features
- Git Sign Column Indicators - Displays Git add, modify, and delete indicators in the sign column for tracked files in Neovim.
- Git Blame Viewers - Inspects commit authorship and date for each line through popups or virtual text annotations directly in the editor buffer.
- Git Diff Viewers - Views line-level Git changes with sign column indicators and inline previews while working on tracked files.
- Inline Hunk Previews - Opens original hunk content in a floating window for comparison against the current buffer.
- Interactive Staging Interfaces - Stages or resets individual hunks of changes directly from the buffer, including partial selections in visual mode.
- Buffer-Based Hunk Staging - Stages or reverts individual hunks of changes directly from the buffer without a separate staging tool.
- Hunk Navigation and Manipulation - Provides hunk navigation between changes, jumping the cursor to the next or previous Git diff hunk.
- Hunk-Based Change Management - Treats individual diff hunks as atomic units for staging, reverting, and navigation operations within the editor.
- Async - Provides asynchronous Git command execution within the editor to prevent UI blocking during repository operations.
- Buffer-Integrated Git Operations - Executes Git commands directly from the editor buffer, eliminating the need for a separate terminal or staging tool.
- Editor Sign Column Markers - Displays visual indicators (add, modify, delete) in the sign column for each changed line in a tracked file.
- Git Diff Sign Column Markers - Displays icons in the sign column to indicate lines that have been added, changed, or deleted in the buffer.
- Sign-Column-Based Diff Rendering - Renders Git add, modify, and delete indicators in the sign column for each changed line in tracked files.
- Buffer-Based Hunk Staging - Stages or reverts individual blocks of changes from the editor buffer without using a separate Git tool.
- Revision Diff Display - Compares the current buffer against any Git revision or index with optional intra-line word highlighting.
- Blame Annotation Navigation - Provides inline blame annotations showing commit authorship and date for each line via popups or virtual text.
- Blame Information Display - Displays commit author and date for each line in popups, virtual text, or full buffer views.
- Inline Blame Annotations - Displays commit author and date for each line as virtual text or in a popup alongside the code.
- Line Blame Display - Reveals the commit, author, and date that last modified a specific line of code directly in the buffer.
- Revision Comparison - Compares the current buffer against the Git index or any specified revision with optional word-level highlighting.
- Hunk List Population - Populates the quickfix or location list with all hunks from the repository, attached buffers, or a specific buffer.
- Hunk Quickfill Lists - Populates quickfix or location lists with all Git hunks for batch review and navigation.
- Quickfix List Population - Populates Neovim's quickfix and location lists with structured hunk data for batch review and navigation.
- Deployment Revisions - Opens the current file at a specified Git revision in a new buffer for inspection.
- File Revision Viewers - Opens the current file as it existed at a specified Git revision in a new buffer.
- Inline Revision Comparisons - Compares the current file against any Git revision or index with inline word-level diff highlighting.
- Diff Region Text Objects - Defines custom text objects that map to contiguous diff hunk regions for visual selection and editing operations.
- Base Diff Display - Displays the full diff of the current buffer against its staged or HEAD version.
- Extmark-Based - Uses Neovim's extmark API to render virtual text and floating window annotations for blame and hunk previews.
- Git Integration - Adds Git signs and hunk actions to the editor.
Star history
How this analysis was created: This summary and feature list were written by an AI model that read the project's README and public documentation pages. Each feature links to the documentation it came from; stars, license and language come straight from the GitHub API. The model does not read the source code, and the analysis is refreshed when the project is re-analysed. Learn more on our About page.
