# Install git-review with Homebrew, apk, apt, dnf, MacPorts, Nix, zypper

Submit git branches to gerrit for review. Version 2.5.0 via Homebrew; verified 2026-05-21.

## Install

```sh
sudo av install brew:git-review
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install git-review
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install git-review
```

  Evidence: MacPorts ports tree: devel/git-review/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- apk (92%):

```sh
sudo apk add git-review
```

  Evidence: Alpine Linux edge package indexes: git-review from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz

- Debian apt (92%):

```sh
sudo apt install git-review
```

  Evidence: Debian stable package indexes: git-review from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz

- dnf (92%):

```sh
sudo dnf install git-review
```

  Evidence: Fedora Rawhide package metadata: git-review from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst

- Nix (92%):

```sh
nix profile install nixpkgs#git-review
```

  Evidence: nixpkgs package indexes: pkgs/by-name/gi/git-review/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- zypper (92%):

```sh
sudo zypper install git-review
```

  Evidence: openSUSE Tumbleweed package metadata: git-review from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

## Package facts

- **Package key:** brew:git-review
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/git-review>
- **Version:** 2.5.0
- **Source summary:** Submit git branches to gerrit for review
- **Homepage:** <https://opendev.org/opendev/git-review>
- **Repository:** <https://opendev.org/opendev/git-review>
- **Upstream docs:** <https://docs.opendev.org/opendev/git-review/latest>
- **License:** Apache-2.0
- **Source archive:** <https://files.pythonhosted.org/packages/da/92/ddc922d34061791a4d0fd483ee4ffc5e026e93783b70fe5a29a129d0cf63/git_review-2.5.0.tar.gz>
- **Last updated:** 2026-05-21T12:11:46Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- git-review (cli)
- git-review (alias)

## Dependencies

- certifi
- python@3.14

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 2.5.0
- Package-manager updated: 2026-05-21
- Local data: ok
- Upstream repository: https://opendev.org/opendev/git-review
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

git-review is an OpenDev tool for submitting Git branches to Gerrit. It standardizes the client-side workflow around `.gitreview` project metadata, Gerrit remotes, Change-Id hooks, and patchset upload/download commands.

### Project history

The project grew out of the OpenStack and OpenDev review workflow, where Gerrit is the central code-review system. Its repository has a long 1.x tag series and a 2.x series documented through OpenDev release notes, reflecting years of adaptation to Gerrit, Git, OpenSSH, and Python changes.

The 2.0.0 release marked a major maintenance boundary by dropping Python 2.7 support and removing Gerrit draft-change options after Gerrit itself removed that state. Later releases added safer hook installation, support for newer Git and OpenSSH behavior, and upload options such as hashtags, patchset messages, and carbon-copy recipients.

### Adoption history

git-review became significant in the OpenStack/OpenDev ecosystem because it turned Gerrit's `refs/for/*` push workflow into a repeatable Git subcommand. Package availability through PyPI, system packages, and Homebrew made it convenient for contributors joining Gerrit-hosted projects.

### How it is used

Practitioners run `git review` to upload the working branch to Gerrit, use options for target branch, topic, reviewers, and CCs, and use `git review -d` to download changes or patchsets for local review. On first run, it can read `.gitreview`, create the Gerrit remote, and install the commit-msg hook used for Change-Id generation.

### Why package nerds care

The package is notable because it encodes a whole hosted-review convention in a small command-line client. For package maintainers and contributors, it reduces Gerrit onboarding friction and keeps repository-specific review metadata versioned alongside the project.

### Timeline

- 1.0: Early public tag in the OpenDev repository.
- 1.28.0: OpenStack-specific topic-name automation removed.
- 2.0.0: Python 2.7 support and Gerrit draft-change upload options removed.
- 2.4.0: Gerrit commit-msg hook embedded for safer setup.
- 2.5.0: CC upload option and branch-filtered review listing added.

### Related projects

- Related projects and systems include Gerrit, OpenDev, OpenStack, Git, and the `.gitreview` metadata convention used by Gerrit-hosted repositories.

### Sources

- <https://formulae.brew.sh/formula/git-review>
- <https://opendev.org/opendev/git-review>
- <https://opendev.org/opendev/git-review/raw/branch/master/README.rst>
- <https://opendev.org/opendev/git-review/raw/branch/master/doc/source/installation.rst>
- <https://opendev.org/opendev/git-review/raw/branch/master/doc/source/releasenotes.rst>
- <https://opendev.org/opendev/git-review/raw/branch/master/doc/source/usage.rst>


## Security Notes

No matching local secret-handling manifest was found for git-review. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: .gitreview, ~/.config/git-review/git-review.conf, /etc/git-review/git-review.conf
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** git-review
- **Version Scheme:** 0
- **Revision:** 7
- **Head Version:** HEAD
- **Conflicts With:** gerrit-tools
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Debian apt - git-review - 2.4.0-1: normalized package name match | Debian stable package indexes: git-review from https://deb.debian.org/debian/dists/stable/main/binary-amd64/Packages.xz | git command for submitting branches to Gerrit | https://opendev.org/opendev/git-review
- Nix - git-review: normalized package name match | nixpkgs package indexes: pkgs/by-name/gi/git-review/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Ubuntu apt - git-review - 2.3.1-3: normalized package name match | Ubuntu 24.04 LTS package indexes: git-review from https://archive.ubuntu.com/ubuntu/dists/noble/universe/binary-amd64/Packages.gz | git command for submitting branches to Gerrit | https://opendev.org/opendev/git-review
- apk - git-review - 2.5.0-r2: normalized package name match | Alpine Linux edge package indexes: git-review from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | git command for submitting branches to Gerrit | https://opendev.org/opendev/git-review
- apk - git-review-doc - 2.5.0-r2: normalized package name match | Alpine Linux edge package indexes: git-review-doc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | git command for submitting branches to Gerrit (documentation) | https://opendev.org/opendev/git-review
- apk - git-review-pyc - 2.5.0-r2: normalized package name match | Alpine Linux edge package indexes: git-review-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for git-review | https://opendev.org/opendev/git-review
- dnf - git-review - 2.3.1-16.fc45: normalized package name match | Fedora Rawhide package metadata: git-review from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | A Git helper for integration with Gerrit | https://opendev.org/opendev/git-review
- zypper - git-review - 2.5.0-1.2: normalized package name match | openSUSE Tumbleweed package metadata: git-review from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Tool to submit code to Gerrit | https://git.openstack.org/cgit/openstack-infra/git-review
- MacPorts - git-review: normalized package name match | MacPorts ports tree: devel/git-review/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew.
- [gerrit-tools](https://www.automicvault.com/pkg/brew/gerrit-tools/) - Shares av.db curated category or tags: cli, code-review, developer-tools, gerrit, git.
- [git-codereview](https://www.automicvault.com/pkg/brew/git-codereview/) - Shares av.db curated category or tags: cli, code-review, developer-tools, gerrit, git.
- [git-gerrit](https://www.automicvault.com/pkg/brew/git-gerrit/) - Shares av.db curated category or tags: cli, code-review, developer-tools, gerrit, git.
- [git-appraise](https://www.automicvault.com/pkg/brew/git-appraise/) - Shares av.db curated category or tags: cli, code-review, developer-tools, git.
- [cargo-crev](https://www.automicvault.com/pkg/brew/cargo-crev/) - Shares av.db curated category or tags: cli, code-review, developer-tools.
- [crit](https://www.automicvault.com/pkg/brew/crit/) - Shares av.db curated category or tags: cli, code-review, developer-tools.
- [prr](https://www.automicvault.com/pkg/brew/prr/) - Shares av.db curated category or tags: cli, code-review, developer-tools.
- [rbtools](https://www.automicvault.com/pkg/brew/rbtools/) - Shares av.db curated category or tags: cli, code-review, developer-tools.
- [bashate](https://www.automicvault.com/pkg/brew/bashate/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, code, developer, developer-tools, python.

## Combined YAML source

View the package source record on GitHub. [combined/git-review.yml](https://github.com/automic-vault/db/blob/main/combined/git-review.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
