Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Helper program to submit changes to gerrit
Branch: master
Pull request Compare This branch is 12 commits ahead of jhansche:master.
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


A git command for submitting branches to Gerrit

git-review is a tool that helps submitting git branches to gerrit for review.


git-review, by default, looks for a git remote called gerrit, and submits the current branch to HEAD:refs/for/master at that remote.

If the "gerrit" remote does not exist, git-review looks for a file called .gitreview at the root of the repository with information about the gerrit remote. Assuming that file is present, git-review should be able to automatically configure your repository the first time it is run.


Hack on some code, then:

git review

If you want to submit that code to a branch other than "master", then:

git review branchname

If you want to submit to a different remote:

git review -r my-remote

If you want to supply a review topic:

git review -t topic/awesome-feature

If you want to submit a branch for review and then remove the local branch:

git review -f

If you want to skip the automatic "git rebase -i" step:

git review -R

If you want to download change 781 from gerrit to review it:

git review -d 781

If you just want to do the commit message and remote setup steps:

git review -s

.gitreview file format

Example .gitreview file (used to upload for git-review itself)


Required values: host, project

Optional values: port


  • Username not required because it is requested on first run
  • Unlike git config files there cannot be any whitespace before the name of the variable.
  • git-review will create a gerrit remote upon first run


Install with pip install git-review

For installation from source simply add git-review to your $PATH


To get the latest code, see:

Bugs are handled at:

Code reviews are, as you might expect, handled by gerrit. The gerrit they use is

Use git review to submit patches (after creating a gerrit account that links to your launchpad account). Example:

# Do your commits
git review
# Enter your username if promped
Something went wrong with that request. Please try again.