{"id":13453152,"url":"https://github.com/rgburke/grv","last_synced_at":"2025-05-15T03:06:24.731Z","repository":{"id":41001455,"uuid":"102900463","full_name":"rgburke/grv","owner":"rgburke","description":"GRV is a terminal interface for viewing git repositories","archived":false,"fork":false,"pushed_at":"2019-05-01T20:02:46.000Z","size":6838,"stargazers_count":4052,"open_issues_count":29,"forks_count":98,"subscribers_count":43,"default_branch":"master","last_synced_at":"2025-04-14T03:07:14.082Z","etag":null,"topics":["git","go","golang","ncurses-tui","terminal-based"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rgburke.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-09-08T20:10:24.000Z","updated_at":"2025-04-13T15:02:09.000Z","dependencies_parsed_at":"2022-07-18T08:13:46.387Z","dependency_job_id":null,"html_url":"https://github.com/rgburke/grv","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rgburke%2Fgrv","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rgburke%2Fgrv/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rgburke%2Fgrv/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rgburke%2Fgrv/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rgburke","download_url":"https://codeload.github.com/rgburke/grv/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254264766,"owners_count":22041793,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["git","go","golang","ncurses-tui","terminal-based"],"created_at":"2024-07-31T08:00:33.778Z","updated_at":"2025-05-15T03:06:19.717Z","avatar_url":"https://github.com/rgburke.png","language":"Go","readme":"# GRV - Git Repository Viewer [![Build Status](https://travis-ci.org/rgburke/grv.svg?branch=master)](https://travis-ci.org/rgburke/grv)\n\nGRV is a terminal based interface for viewing Git repositories. It allows\nrefs, commits and diffs to be viewed, searched and filtered. The behaviour\nand style can be customised through configuration. A query language can\nbe used to filter refs and commits, see the [Documentation](#documentation)\nsection for more information.\n\n![Screenshot](./doc/grv-history-view.png)\n\nMore screenshots can be seen [here](doc/screenshots.md)\n\n## Features\n\n - Commits and refs can be filtered using a query language.\n - Changes to the repository are captured by monitoring the filesystem allowing the UI to be updated automatically.\n - Organised as tabs and splits. Custom tabs and splits can be created using any combination of views.\n - Vi like keybindings by default, key bindings can be customised.\n - Custom themes can be created.\n - Mouse support.\n - Commit Graph.\n\n## Documentation\n\nDocumentation for GRV is available [here](doc/documentation.md)\n\n## Install\n\n**Note:** `grv` is currently an alias used by oh-my-zsh. Add `unalias grv` to the end of your `.zshrc` to invoke GRV.\n\n### Linux\n\nStatic binaries are available for Linux. For example, to use\nthe amd64 binary run the following steps:\n\n```\nwget -O grv https://github.com/rgburke/grv/releases/download/v0.3.2/grv_v0.3.2_linux64\nchmod +x ./grv\n./grv -repoFilePath /path/to/repo\n```\n\n### Mac\n\nGRV is available in homebrew and can be installed with:\n\n```\nbrew install grv\n```\n\n### FreeBSD\n\nGRV can be installed as a binary package\n\n```\npkg install grv\n```\n\nor from ports\n\n```\ncd /usr/ports/devel/grv \u0026\u0026 make install clean\n```\n\n## Build instructions\n\nGo version 1.8 or later is required. GRV depends on the following libraries:\n\n - libncursesw\n - libreadline\n - libcurl\n - cmake (to build libgit2)\n\nBuilding GRV on OSX requires homebrew, and for `readline`, `pkg-config`, and `cmake` to be installed using homebrew:\n\n```\nbrew install readline pkg-config cmake\n```\n\nTo install GRV run:\n\n```\ngo get -d github.com/rgburke/grv/cmd/grv\ncd $GOPATH/src/github.com/rgburke/grv\nmake install\n```\n\nTo install grv with an alternative binary name change the last step to:\n\n```\nmake install BINARY=NewBinaryName\n```\n\nwhere `NewBinaryName` is the alternative name to use instead.\n\nThe steps above will install GRV to `$GOPATH/bin`. A static libgit2 will be built and\nincluded in GRV when built this way. Alternatively if libgit2 version 0.27 is\ninstalled on your system GRV can be built normally:\n\n```\ngo install ./cmd/grv\n```\n","funding_links":[],"categories":["Go","\\*nix/\\*nux","Version Control","Go (531)","golang","Repositories","\u003ca name=\"git\"\u003e\u003c/a\u003eGit and accessories","Table of Contents"],"sub_categories":["Version Control","Git"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frgburke%2Fgrv","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frgburke%2Fgrv","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frgburke%2Fgrv/lists"}