minifugit.nvim

A lightweight Git status UI for Neovim, inspired by vim-fugitive.

minifugit.nvim focuses on a compact status window for everyday Git operations without leaving Neovim.

Features

• Open a Git status window with :MinifugitStatus.
• View your files' status.
• Discard unstaged changes or delete untracked paths, with confirmation by

• Stage and unstage files from the status window (visual mode as well).
• Preview diffs for the entry under the cursor in stacked or split view.
• Stage and unstage hunks from the diff window.
• Create commits.
• Animated loading spinner while pushing your commits.
• View unpushed commits in the status window and preview the diffs.
• Run :checkhealth minifugit to verify Neovim and Git requirements.

Requirements

• Neovim 0.10+
• git executable on PATH

Configuration

vim.pack

vim.pack.add({
    'https://github.com/vieitesss/minifugit.nvim',
    version = vim.version.range("*") -- stable version
    -- version = "nightly"
})

lazy.nvim

{
    'vieitesss/minifugit.nvim',
}

Options

minifugit works without setup. Configure it with vim.g.minifugit before the plugin loads:

vim.g.minifugit = {
    preview = {
        -- Start diff previews with wrapping disabled.
        wrap = false,
-- Show old/new line numbers in diff previews.         showlinenumbers = true,
-- Show git diff metadata rows such as diff --git, index, ---,         -- and +++.         show_metadata = true,
-- Diff preview layout: 'stacked', 'split', or 'auto'.         diff_layout = 'stacked',
-- Editor width where 'auto' switches from stacked to split.         diffautothreshold = 120,     },     status = {         -- Fraction of the editor width used by the status window.         width = 0.4,
-- Minimum status window width in columns.         min_width = 20,
-- Open the minifugit workflow in a dedicated tab.         openintab = false,     }, }

Or use setup() if your plugin manager expects Lua options:

require('minifugit').setup({
    preview = {
        diff_layout = 'auto',
    },
})

Diff-preview mappings can toggle preview.wrap, preview.showlinenumbers, preview.show_metadata, and the diff layout at runtime for the current status session.

Usage

Open the status window:

:MinifugitStatus

require('minifugit').status()

Default status-window mappings:

| Mode | Key | Action | | --- | --- | --- | | n | <CR> / o | Open the file or commit under the cursor | | n | = | Preview the diff for the entry under the cursor | | n | q | Close the status window | | n | / | Filter entries by path or summary | | n | <BS> | Clear the active filter | | n | r | Refresh Git status data | | n | s | Stage entry, or unstage it if already staged | | v | s | Stage the selected entries | | n,v | u | Unstage the entry or selected entries | | n | S | Stage all visible entries | | n | U | Unstage all visible entries | | n | d | Discard the entry with confirmation | | n | D | Discard the entry without confirmation | | n | c | Commit staged changes | | n | p | Push unpushed commits | | n | aw | Alternate diff preview line wrapping | | n | an | Alternate diff preview line numbers | | n | am | Alternate stacked diff preview metadata rows | | n | al | Alternate diff preview stacked/split layout | | n | ? | Toggle mappings help |

Default diff-preview mappings:

| Mode | Key | Action | | --- | --- | --- | | n | q | Close the diff preview | | n | <CR> | Open the file at the diff line under the cursor | | n | [h / ]h | Jump to the previous/next hunk | | n | s | Stage the hunk under the cursor | | n | u | Unstage the hunk under the cursor | | n | d | Discard the hunk under the cursor with confirmation | | n | aw | Alternate line wrapping | | n | an | Alternate line numbers | | n | am | Alternate metadata rows (stacked only) | | n | al | Alternate stacked/split layout | | n | ? | Toggle mappings help |