vim-flog icon indicating copy to clipboard operation
vim-flog copied to clipboard

A fast, beautiful, and powerful git branch viewer for vim.

Flog

test status

Flog is a lightweight and powerful git branch viewer that integrates with fugitive.

flog in action

Installation

Using Plug add the following to your .vimrc:

Plug 'tpope/vim-fugitive'
Plug 'rbong/vim-flog'

See :help plug-example for more information. If you do not use plug, see your plugin manager of choice's documentation.

Requires vim version 8 or greater. Neovim is also supported.

Using Flog

Open the commit graph with :Flog or :Flogsplit. Many options can be passed in, complete with <Tab> completion.

Open commits in temporary windows once you've opened Flog using <CR>. Jump between commits with <C-N> and <C-P>.

Refresh the graph with u. Toggle viewing all branches with a. Toggle bisect mode with gb. Toggle displaying no merges with gm. Toggle viewing the reflog with gr. Quit with gq.

Many of the bindings that work in fugitive in :Gstatus windows will work in Flog.

To see more bindings or get a refresher, press g?.

Run :Git commands in a split next to the graph using :Floggit -p. Command line completion is provided to do any git command with the commits and refs under the cursor.

You can do a lot more with Flog. Flog can be heavily customized, and comes with utility functions for defining your own commands. See the examples for more details.

Getting Help

If you have questions, requests, or bugs, see the issue tracker and :help flog.

Please see fugitive for help with Fugitive commands. See git log --help for any problems specific to git log.

More info:

  • FAQ
  • Examples
  • Contributing