wsdjeg/git.nvim

github

git

7

0

1

0

CREATED

2025-04-03

UPDATED

2025-10-31

---

git.nvim

git.nvim is an asynchronous git command wrapper plugin, using :Git command instead of :!git.

• Installation
• Usage
  • git-branch
• Statusline
• Picker sources
• Self-Promotion
• Feedback

Installation

Use your preferred Neovim plugin manager to install git.nvim.

with nvim-plug

require('plug').add({
    {
        'wsdjeg/git.nvim',
        depends = {
            { 'wsdjeg/job.nvim' },
            { 'wsdjeg/notify.nvim' },
            { 'wsdjeg/logger.nvim' }, -- not strictly required
            { 'wsdjeg/rooter.nvim' }, -- not strictly required
            { 'wsdjeg/plugin-utils.nvim' }, -- not strictly required
        },
    },
})

Then use :PlugInstall git.nvim to install this plugin.

Usage

• :Git add %: stage current file.
• :Git add .: stage all files
• :Git commit: edit commit message
• :Git push: push to remote
• :Git pull: pull updates from remote
• :Git fetch: fetch remotes
• :Git checkout: checkout branches
• :Git log %: view git log of current file
• :Git config: list all git config
• :Git reflog: manage reflog information
• :Git branch: list, create, or delete branches
• :Git rebase: rebase git commit
• :Git diff: view git-diff info

The plugin does not provide default key binding, here is an example:

vim.keymap.set('n', '<leader>gs', '<cmd>Git status<cr>', { silent = true })
vim.keymap.set('n', '<leader>gA', '<cmd>Git add .<cr>', { silent = true })
vim.keymap.set('n', '<leader>gc', '<cmd>Git commit<cr>', { silent = true })
vim.keymap.set('n', '<leader>gv', '<cmd>Git log<cr>', { silent = true })
vim.keymap.set('n', '<leader>gV', '<cmd>Git log %<cr>', { silent = true })
vim.keymap.set('n', '<leader>gp', '<cmd>Git push<cr>', { silent = true })
vim.keymap.set('n', '<leader>gd', '<cmd>Git diff<cr>', { silent = true })

git-branch

:Git branch without argument will open branch manager, within the branch manager these key bindings are available:

Statusline

If you want to display branch info on statusline, you can use v:lua.require("git.command.branch").current(), for example:

using statusline.nvim:

require('plug').add({
  {
    'wsdjeg/statusline.nvim',
    events = { 'VimEnter' },
    config = function()
      require('statusline').register_sections('vcs', function()
        return '%{ v:lua.require("git.command.branch").current() }'
      end)
      require('statusline').setup({
        left_sections = { 'winnr', 'filename', 'vcs' },
      })
    end,
  },
})

Picker sources

This plugin also provides sources for picker.nvim

• git-branch: fuzzy find git branch to checkout

Self-Promotion

Like this plugin? Star the repository on GitHub.

Love this plugin? Follow me on GitHub

Feedback

If you encounter any bugs or have suggestions, please file an issue in the issue tracker