Floggit is a fast commandline git log viewer, with vim-like keybindings that are fully configured by default, but completely configurable and extendable if desired. It is built as a Domain Specific Vimconfig - a set of vimplugins bundled together with a one-liner that calls (Neo)vim in such a way that the custom vimplugins and customized startup vimrc are used. We also provide our own floggitrc configuration, so that you can run (Neo)vim alongside floggit (and other DSV's) without interfering with the configuration. It's also easy to merge a DSV into an existing Neovim configuration, or combine DSV's by adding one as the config for the other.
Start floggit in a git repository to see a log with commit message headers.
Default keybindings:
gq Quit
<control-hjkl> Move between windows
<enter> Open commit at cursor
<space>g Browse global / current file keybindings
<space>gs Open git status window
<space>m Open menu on current commit
<space>h Move to previous tab
<space>l Move to next tab
Under the hood, this is just a script that calls NeoVim, passing along its own vimrc to use, so that your own vimrc, even if present, is neither read nor affected. This list of plugins is used; some of those were specifically made for floggit, and just contain keybindings for the plugins. This makes it easy to override parts of floggit while leaving other parts standard, or adding on configuration while keeping defaults.
You need NeoVim installed, and curl and git:
sudo apt install curl git
There's an install script for Ubuntu:
curl -o- https://raw.githubusercontent.com/TamaMcGlinn/floggit/master/install_floggit | bash -x
Otherwise, do the following steps:
git clone git@github.com:TamaMcGlinn/floggit
curl -fLo ~/.floggit/autoload/plug.vim --create-dirs https://raw.githubusercontent.com/junegunn/vim-plug/master/plug.vim
Then add the floggit/bin directory to your $PATH, and . For example, if you cloned floggit in your $HOME directory, put this in ~/.bashrc:
export PATH="$PATH:$HOME/floggit/bin"
You need to run floggit -c PlugInstall the first time,
to install the vim plugins. After that you can just do floggit.
Run floggit -c PlugUpdate to update the (neo)vim plugins that make floggit tick.
Adding to ~/.floggit/floggitrc.vim is the simplest way. Any valid vimscript can be added there; for example, to add a keybinding to make the current file executable, you could add:
nnoremap <leader>fx :!chmod +x %<CR>If you want to add (neo)vim plugins to floggit, add Plug installation lines to your ~/.floggit/extra_plugins.vim, for example, to install vim-markdown:
Plug 'tpope/vim-markdown'If you want to remove the default plugins, write to ~/.floggit/plugins.vim, and the defaults will not be loaded.