git.nvim

git.nvim is a plugin to use git command in Neovim.

• Installation
• Usage
• Statusline
• 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
    },
  },
})

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 })

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,
  },
})

Self-Promotion

Like this plugin? Star the repository on GitHub.

Love this plugin? Follow me on GitHub and Twitter.

Feedback

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