How to customize keybindings in GRV?

Edit the GRV configuration file to map keys to actions; the README states keybindings are fully customizable, and documentation provides syntax examples for personalizing vi-like defaults.

GRV vs tig: which is better for Git history?

GRV offers more customization with real-time updates and a query language, while tig is simpler and more lightweight. Choose GRV for advanced filtering and themes, or tig for a straightforward, widely-used tool.

Can GRV handle large repositories efficiently?

GRV monitors filesystem changes for real-time updates, but performance may vary with repository size; the commit graph and efficient filtering help navigate extensive histories, though resource usage depends on system capabilities.

How to create a custom theme in GRV?

Define color schemes in the configuration file; the documentation details the theme format, allowing users to personalize interface colors and styles for a tailored terminal experience.

Does GRV support Windows?

No, GRV primarily supports Linux, Mac via Homebrew, and FreeBSD, with no official Windows support mentioned, making it unsuitable for Windows-based development environments.

What are the system requirements for building GRV from source?

Requires Go 1.8 or later, and dependencies like libncursesw, libreadline, libcurl, and cmake; on Mac, Homebrew installations of readline, pkg-config, and cmake are needed, adding setup steps.

Open-Awesome

grv

GPL-3.0Gov0.3.2

A terminal-based interface for viewing, searching, and filtering Git repositories with vi-like keybindings.

GitHub

4.1k stars98 forks0 contributors

What is grv?

GRV is a terminal-based Git repository viewer that provides an interactive interface for exploring commits, refs, and diffs. It allows developers to search, filter, and visualize Git history directly in the terminal, with real-time updates as the repository changes. The tool is designed to enhance productivity by offering a customizable, keyboard-driven alternative to command-line Git log commands.

Target Audience

Developers and system administrators who frequently work with Git repositories in terminal environments and prefer a text-based interface for efficient repository navigation and history analysis.

Value Proposition

GRV stands out by combining a powerful query language for filtering commits and refs with real-time repository monitoring, vi-like keybindings, and extensive customization options, all within a lightweight terminal interface.

Overview

GRV is a terminal interface for viewing git repositories

Use Cases

Best For

Exploring complex Git histories with advanced filtering and search
Visualizing commit graphs and branch relationships in the terminal
Monitoring repository changes in real time during active development
Customizing Git workflow with personalized keybindings and themes
Navigating large repositories efficiently without GUI tools
Analyzing diffs and refs interactively in a command-line environment

Not Ideal For

Developers who prefer graphical Git clients with drag-and-drop interfaces
Teams needing quick, out-of-the-box Git visualization without learning a custom query language
Environments where Windows is the primary OS, as support is not mentioned

Pros & Cons

Pros

Advanced Filtering Capabilities

GRV's custom query language enables precise searching and filtering of commits and refs, allowing complex history exploration beyond basic Git log commands.

Real-Time Repository Monitoring

By monitoring filesystem changes, GRV automatically updates its UI when the repository changes, keeping views current without manual refreshes.

Highly Customizable Interface

Supports custom layouts with tabs and splits, fully customizable vi-like keybindings, and user-created themes for personalized terminal styling.

Terminal-Native Efficiency

Designed as a keyboard-driven tool with mouse support, it integrates seamlessly into command-line workflows, avoiding context switches to GUI applications.

Cons

Setup and Installation Hurdles

Conflicts with oh-my-zsh's 'grv' alias require manual unaliasing, and building from source depends on multiple libraries like libncursesw and libgit2, increasing complexity.

Limited Cross-Platform Support

While available via package managers for Mac and FreeBSD, Linux relies on static binaries, and Windows support is absent, restricting usability across environments.

Steep Learning Curve

The custom query language, though powerful, adds an extra layer of complexity that users must master, unlike simpler Git viewers or standard commands.

Frequently Asked Questions

Related Projects

lazygit

simple terminal UI for git commands

Blazing 💥 fast terminal-ui for git written in rust 🦀

Stars22,072

Forks734

Last commit12 days ago

readme-md-generator

📄 CLI that generates beautiful README.md files

Stars11,112

Forks1,374

Last commit3 years ago

git-standup

Recall what you or your team did on the last working day

Stars7,841

Forks319

Last commit11 months ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub

grv