Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/junegunn/gv.vim

A git commit browser in Vim
https://github.com/junegunn/gv.vim

Last synced: about 2 months ago
JSON representation

A git commit browser in Vim

Awesome Lists containing this project

README

        

gv.vim
======

A git commit browser.

![gv](https://cloud.githubusercontent.com/assets/700826/12355378/8bbf0834-bbdf-11e5-9389-1aba7cd1fec1.png)

[gitv](https://github.com/gregsexton/gitv) is nice. But I needed a faster, and
possibly simpler alternative that I can use with a project with thousands of
commits.

Installation
------------

Requires fugitive.

Using [vim-plug](https://github.com/junegunn/vim-plug):

```vim
Plug 'tpope/vim-fugitive'
Plug 'junegunn/gv.vim'
```

Usage
-----

### Commands

- `:GV` to open commit browser
- You can pass `git log` options to the command, e.g. `:GV -S foobar -- plugins`.
- `:GV!` will only list commits that affected the current file
- `:GV?` fills the location list with the revisions of the current file

`:GV` or `:GV?` can be used in visual mode to track the changes in the
selected lines.

### Mappings

- `o` or `` on a commit to display the content of it
- `o` or `` on commits to display the diff in the range
- `O` opens a new tab instead
- `gb` for `:GBrowse`
- `]]` and `[[` to move between commits
- `.` to start command-line with `:Git [CURSOR] SHA` à la fugitive
- `q` or `gq` to close

Customization
-------------

`¯\_(ツ)_/¯`