Need help with grv?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

rgburke
3.8K Stars 92 Forks GNU General Public License v3.0 593 Commits 24 Opened issues

Description

GRV is a terminal interface for viewing git repositories

Services available

!
?

Need anything else?

Contributors list

# 33,010
Git
Shell
Go
termina...
565 commits
# 89,225
adafrui...
golang
gitlab-...
suckles...
2 commits
# 44,076
keyboar...
React
React N...
scrollv...
2 commits
# 61,211
golang
xorm
aws-lam...
D
1 commit
# 3,896
Ruby
html-fo...
json-fo...
Git
1 commit
# 41,635
golang
logisti...
scikit-...
React
1 commit
# 176,857
node
youtube...
Redux
Angular
1 commit
# 218,322
srtm
elixir-...
Zsh
python3
1 commit
# 117,063
github-...
CSS
postman...
Jenkins
1 commit
# 9,320
Go
viml
golang
local-d...
1 commit
# 62,031
kakoune
Crystal
Vim
modal-e...
1 commit
# 11,444
Go
binary-...
multipl...
query-l...
1 commit

GRV - Git Repository Viewer Build Status

GRV is a terminal based interface for viewing Git repositories. It allows refs, commits and diffs to be viewed, searched and filtered. The behaviour and style can be customised through configuration. A query language can be used to filter refs and commits, see the Documentation section for more information.

Screenshot

More screenshots can be seen here

Features

  • Commits and refs can be filtered using a query language.
  • Changes to the repository are captured by monitoring the filesystem allowing the UI to be updated automatically.
  • Organised as tabs and splits. Custom tabs and splits can be created using any combination of views.
  • Vi like keybindings by default, key bindings can be customised.
  • Custom themes can be created.
  • Mouse support.
  • Commit Graph.

Documentation

Documentation for GRV is available here

Install

Note:

grv
is currently an alias used by oh-my-zsh. Add
unalias grv
to the end of your
.zshrc
to invoke GRV.

Linux

Static binaries are available for Linux. For example, to use the amd64 binary run the following steps:

wget -O grv https://github.com/rgburke/grv/releases/download/v0.3.2/grv_v0.3.2_linux64
chmod +x ./grv
./grv -repoFilePath /path/to/repo

Mac

GRV is available in homebrew and can be installed with:

brew install grv

FreeBSD

GRV can be installed as a binary package

pkg install grv

or from ports

cd /usr/ports/devel/grv && make install clean

Build instructions

Go version 1.8 or later is required. GRV depends on the following libraries:

  • libncursesw
  • libreadline
  • libcurl
  • cmake (to build libgit2)

Building GRV on OSX requires homebrew, and for

readline
,
pkg-config
, and
cmake
to be installed using homebrew:
brew install readline pkg-config cmake

To install GRV run:

go get -d github.com/rgburke/grv/cmd/grv
cd $GOPATH/src/github.com/rgburke/grv
make install

To install grv with an alternative binary name change the last step to:

make install BINARY=NewBinaryName

where

NewBinaryName
is the alternative name to use instead.

The steps above will install GRV to

$GOPATH/bin
. A static libgit2 will be built and included in GRV when built this way. Alternatively if libgit2 version 0.27 is installed on your system GRV can be built normally:
go install ./cmd/grv

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.