agitator.nvim

agitator is a neovim/lua plugin providing some git-related functions:

blame

Blame adds a window on the left side of your window with blame information for the file. The sidebar is scroll bound to the main file window. Three functions are exported:

• git_blame({sidebar_width?}): open the sidebar. The default width is 30 characters, you can optionally pass another width in a record, eg {sidebar_width = 20};
• git_blame_close(): close the blame sidebar;
• git_blame_toggle(): toggle (open or close) the blame sidebar.

git find file

Git find file will open two telescope pickers in succession. The first one to pick a git branch; the second one to pick a file from that branch. The selected file from another branch is then displayed in a read-only buffer.

• open_file_git_branch()

time machine

The time machine allows you to see the history of a single file through time. It opens a new read-only window, where you can navigate through past versions of the file and view their contents. Details about the currently displayed version appear in a popup window.

• git_time_machine()

General

To call any function, if you use a plugin manager such as Packer, you must prepend require('agitator'). For instance require('agitator').git_blame().

I'm really a beginner in nvim/lua, so don't be surprised if some things are strangely or wrongly implemented. There are also a couple of ugly hacks. Pull requests are welcome. I'll do my best to fix bugs, but don't expect too much.

This plugin has two dependencies: telescope.nvim and plenary.nvim.

The plugin is meant to be combined with gitsigns, neogit and diffview, so I won't add features covered by these.