LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

grv

Terminal interface for viewing Git repositories

TLDR

Open the current repository in grv
$ grv
copy
Open a specific repository
$ grv -repoFilePath [path/to/repo]
copy
Open with a specific log level
$ grv -logLevel [NONE|PANIC|FATAL|ERROR|WARN|INFO|DEBUG|TRACE]
copy
Open in read-only mode
$ grv -readOnly
copy

SYNOPSIS

grv [-repoFilePath path] [-workTreeFilePath path] [-logFile path] [-logLevel level] [-readOnly] [-version]

DESCRIPTION

GRV (Git Repository Viewer) is a terminal-based interface for viewing Git repositories. It allows refs, commits, and diffs to be viewed, searched, and filtered using Vi/Vim-like key bindings. The interface provides multiple views including a ref view for branches and tags, a commit view for browsing history, and a diff view for inspecting changes.GRV reads the repository directly using libgit2 rather than shelling out to git commands, resulting in fast navigation even in large repositories. The behaviour and style can be customised through a .grvrc configuration file.

PARAMETERS

-repoFilePath path

Repository file path (default: ".")
-workTreeFilePath path
Work tree file path
-logFile path
Log file path (default: "grv.log")
-logLevel level
Logging level: NONE, PANIC, FATAL, ERROR, WARN, INFO, DEBUG, TRACE (default: "NONE")
-readOnly
Run grv in read-only mode
-version
Print version information

KEY BINDINGS

j/k — Move down/upEnter — Select item / open viewq — Close view / quit/ — Searchn/N — Next/previous search matchTab — Switch between views1-5 — Jump to specific view

CAVEATS

GRV is no longer actively maintained (last release 2019). It reads git repository data directly using libgit2, so very large repositories may use significant memory. Read-only; does not support write operations like committing or pushing. Consider lazygit or gitui as actively maintained alternatives.

HISTORY

GRV was created by Robert Burke and written in Go. It was designed as a lightweight alternative to graphical Git clients, providing a fast terminal-based workflow for inspecting repository history and diffs.

SEE ALSO

git(1), tig(1), gitui(1), lazygit(1)

Copied to clipboard
Kai