oil-git.nvim

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

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

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

• Neovim >= 0.8
• oil.nvim
• Git

License

MIT