oil-git.nvim

March 2, 2026 · View on GitHub

Git status integration for oil.nvim that shows git status by coloring file names and adding status symbols.

Screenshot

Screenshot

Features

  • 🎨 File name highlighting - Colors files based on git status
  • 📝 Status symbols - Shows git symbols at end of lines
  • 🚀 Real-time updates - Automatically refreshes when git changes occur
  • 🔄 LazyGit integration - Updates instantly when closing LazyGit or other git tools

Installation

With LazyVim/lazy.nvim (No setup required!)

{
  "benomahony/oil-git.nvim",
  dependencies = { "stevearc/oil.nvim" },
  -- No opts or config needed! Works automatically
}

Optional configuration

{
  "benomahony/oil-git.nvim",
  dependencies = { "stevearc/oil.nvim" },
  opts = {
    highlights = {
      OilGitModified = { fg = "#ff0000" }, -- Custom colors
    }
  }
}

With other plugin managers

-- Packer (no setup required)
use {
  "benomahony/oil-git.nvim",
  requires = { "stevearc/oil.nvim" },
}

-- Plug (no setup required)
Plug 'stevearc/oil.nvim'
Plug 'benomahony/oil-git.nvim'

Colorscheme Integration

The plugin respects highlight groups defined in your colorscheme. Add these to your colorscheme or init.lua:

-- Example: Custom colors in your colorscheme
vim.cmd([[
  highlight OilGitAdded guifg=#00ff00
  highlight OilGitModified guifg=#ffff00  
  highlight OilGitRenamed guifg=#ff00ff
  highlight OilGitUntracked guifg=#00ffff
  highlight OilGitIgnored guifg=#808080
]])

The plugin only sets default colors if highlight groups don't already exist.

Configuration

require("oil-git").setup({
  highlights = {
    OilGitAdded = { fg = "#a6e3a1" },     -- green
    OilGitModified = { fg = "#f9e2af" },  -- yellow  
    OilGitRenamed = { fg = "#cba6f7" },   -- purple
    OilGitUntracked = { fg = "#89b4fa" }, -- blue
    OilGitIgnored = { fg = "#6c7086" },   -- gray
  }
})

Git Status Display

StatusSymbolColorDescription
Added+GreenStaged new file
Modified~YellowModified file (staged or unstaged)
Renamed→PurpleRenamed file
Untracked?BlueNew untracked file
Ignored!GrayIgnored file

Auto-refresh Triggers

The plugin automatically refreshes git status when:

  • Entering an oil buffer
  • Buffer content changes (file operations in oil)
  • Focus returns to Neovim (after using external git tools)
  • Window focus changes
  • Terminal closes (LazyGit, fugitive, etc.)
  • Git plugin events (GitSigns, Fugitive)

Commands

  • :lua require("oil-git").refresh() - Manually refresh git status

Requirements

License

MIT