Plugin for calling lazygit from within neovim.
See akinsho/nvim-toggleterm or voldikss/vim-floaterm as an alternative to this package.
Install using vim-plug
:
" nvim v0.5.0
Plug 'kdheepak/lazygit.nvim'
Feel free to use any plugin manager.
Just remember that if you are not using the latest neovim release, you will need to use the nvim-v0.4.3
branch.
Integration with nvr
works better on the main
branch.
You can check what version of neovim
you have:
nvim --version
The following are configuration options and their defaults.
let g:lazygit_floating_window_winblend = 0 " transparency of floating window
let g:lazygit_floating_window_scaling_factor = 0.9 " scaling factor for floating window
let g:lazygit_floating_window_corner_chars = ['╭', '╮', '╰', '╯'] " customize lazygit popup window corner characters
let g:lazygit_floating_window_use_plenary = 0 " use plenary.nvim to manage floating window if available
let g:lazygit_use_neovim_remote = 1 " fallback to 0 if neovim-remote is not installed
Call :LazyGit
to start a floating window with lazygit
.
And set up a mapping to call :LazyGit
:
" setup mapping to call :LazyGit
nnoremap <silent> <leader>gg :LazyGit<CR>
Open the configuration file for lazygit
directly from vim.
:LazyGitConfig<CR>
If the file does not exist it'll load the defaults for you.
Open project commits with lazygit
directly from vim in floating window.
:LazyGitFilter<CR>
Open buffer commits with lazygit
directly from vim in floating window.
:LazyGitFilterCurrentFile<CR>
Using neovim-remote
If you have neovim-remote and have configured to use it in neovim, it'll launch the commit editor inside your neovim instance when you use C
inside lazygit
.
-
pip install neovim-remote
-
Add the following to your
~/.bashrc
:
if [ -n "$NVIM_LISTEN_ADDRESS" ]; then
alias nvim=nvr -cc split --remote-wait +'set bufhidden=wipe'
fi
- Set
EDITOR
environment variable in~/.bashrc
:
if [ -n "$NVIM_LISTEN_ADDRESS" ]; then
export VISUAL="nvr -cc split --remote-wait +'set bufhidden=wipe'"
export EDITOR="nvr -cc split --remote-wait +'set bufhidden=wipe'"
else
export VISUAL="nvim"
export EDITOR="nvim"
fi
- Add the following to
~/.vimrc
:
if has('nvim') && executable('nvr')
let $GIT_EDITOR = "nvr -cc split --remote-wait +'set bufhidden=wipe'"
endif
If you have neovim-remote
and don't want lazygit.nvim
to use it, you can disable it using the following configuration option:
let g:lazygit_use_neovim_remote = 0
The Telescope plugin is used to track all git repository visited in one nvim session.
(background image is not included 😏)
Why a telescope Plugin ?
Assuming you have one or more submodule(s) in your project and you want to commit changes in both the submodule(s) and the main repo. Though switching between submodules and main repo is not straight forward. A solution at first could be:
- open a file inside the submodule
- open lazygit
- do commit
- then open a file in the main repo
- open lazygit
- do commit
That is really annoying. Instead, you can open it with telescope.
How to use
Install the plugin using:
use({
"nvim-telescope/telescope.nvim",
requires = { { "nvim-lua/plenary.nvim" }, { "kdheepak/lazygit.nvim" } },
config = function()
require("telescope").load_extension("lazygit")
end,
})
Lazy loading lazygit.nvim
for telescope functionality is not supported. Open an issue if you wish to have this feature.
If you are not using Packer, to load the telescope extension, you have to add this line to your configuration:
require('telescope').load_extension('lazygit')
By default the paths of each repo is stored only when lazygit is triggered. Though, this may not be convenient, so it possible to do something like this:
autocmd BufEnter * :lua require('lazygit.utils').project_root_dir()
That makes sure that any opened buffer which is contained in a git repo will be tracked.
Once you have loaded the extension, you can invoke the plugin using:
lua require("telescope").extensions.lazygit.lazygit()