Skip to content
gri: gerrit command line interface
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore Let there be light, and colors Sep 3, 2019
.pre-commit-config.yaml Let there be light, and colors Sep 3, 2019
LICENSE Let there be light, and colors Sep 3, 2019 Documented related tools Sep 14, 2019
pyproject.toml Fixed packaging Sep 6, 2019
setup.cfg Fixed packaging Sep 6, 2019 Let there be light, and colors Sep 3, 2019
tox.ini Fixed packaging Sep 6, 2019

gri : Gerrit Reduced Interface

gri¹ is a CLI tool that will list your open git reviews from multiple servers in a way that makes easier to to identify which one need.



  • multiple Gerrit servers
  • change number and topics are clickable links
  • draft/dnm/wip changes are grayed out


  • Configurable Gerrit servers
  • Sorting :: top ones should be those closer to be merged
  • Grouping
  • Caching
  • Dependency graph based on zuul Depends-On
  • Configurable query
  • Include starred changes
  • Zuul build status support
  • top mode :: so it can auto-refresh and notify you of important changes


pip install gri


Currently the tool loads gerrit servers defined in ~/.gertty.yaml but uses credentials from ~/.netrc file.

So use it just run gli, or python -m gri.


Are you missing a feature, just check if there is a bug open for it and add a new one if not. Once done, you are welcomed to make a PR that implements the missing change.

Related tools

  • git-review is the git extension for working with gerrit, where I am also one of the core contributors.
  • GerTTY is a very useful tui for gerrit which inspired me but which presents one essential design limitation: it does not work with multiple Gerrit servers.
  • Gerrit-View is a vscode plugin that can be installed from Visual Studio Marketplace.


  1. The reality is that gri name comes from my attempt to find a short namespace on pypi that was starting with g (from Gerrit) and preferably sounds like cli, most were taken. You are welcomed to propose better acronym expansions.
You can’t perform that action at this time.