google/git-appraise — 5.3k★ on GitHub (Go). Distributed code review system for Git repos
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
This repo contains a command line tool for performing code reviews on git
repositories.
Overview
This tool is a distributed code review system for git repos.
By "distributed", we mean that code reviews are stored inside of the repository
as git objects. Every developer on your team has their own copy of the review
history that they can push or pull. When pulling, updates from the remote
repo are automatically merged by the tool.
This design removes the need for any sort of server-side setup. As a result,
this tool can work with any git hosting provider, and the only setup required
is installing the client on your workstation.
Installation
Assuming you have the Go tools installed, run
the following command:
go install github.com/google/git-appraise/git-appraise@latest
Then, either make sure that ${GOPATH}/bin is in your PATH, or explicitly add the
"appraise" git alias by running the following command.
A more detailed getting started doc is available here.
Metadata
The code review data is stored in git-notes,
using the formats described below. Each item stored is written as a single
line of JSON, and is written with at most one such item per line. This allows
the git notes to be automatically merged using the "cat_sort_uniq" strategy.
Since these notes are not in a human-friendly form, all of the refs used to
track them start with the prefix "refs/notes/devtools". This helps make it
clear that these are meant to be read and written by automated tools.
When a field named "v" appears in one of these notes, it is used to denote
the version of the metadata format being used. If that field is missing, then
it defaults to the value 0, which corresponds to this initial version of the
formats.
Code Review Requests
Code review requests are stored in the "refs/notes/devtools/reviews" ref, and
annotate the first revision in a review. They must conform to the
request schema.
If there are multiple requests for a single commit, then they are sorted by
timestamp and the final request is treated as the current one. This sorting
should be done in a stable manner, so that if there are multiple requests
with the same timestamp, then the last such request in the note is treated
as the current one.
This design allows a user to update a review request by re-running the
git appraise request command.
Continuous Integration Status
Continuous integration build and test results are stored in the
"refs/notes/devtools/ci" ref, and annotate the revision that was built and
tested. They must conform to the ci schema.
Robot Comments
Robot comments are comments generated by static analysis tools. These are
stored in the "refs/notes/devtools/analyses" ref, and annotate the revision.
They must conform to the analysis schema.
Review Comments
Review comments are comments that were written by a person rather than by a
machine. These are stored in the "refs/notes/devtools/discuss" ref, and
annotate the first revision in the review. They must conform to the
comment schema.
Integrations
Libraries
Go (use git-appraise itself)
Rust
Graphical User Interfaces
Git-Appraise-Web
Plugins
Eclipse
Jenkins
Mirrors to other systems
GitHub Pull Requests
Phabricator Revisions
Contributing
Please see the CONTRIBUTING file for information on contributing to Git Appraise.
TopGit's last sync did not record any GitHub topics for google/git-appraise. GitHub topics appear in the right sidebar of a repository page; that's the authoritative place to check.
How active is development on google/git-appraise?
The most recent commit recorded on google/git-appraise was 3.3 years ago, based on the GitHub push timestamp. The repository has 148 forks — one of the better signals of community interest.
How many stars does google/git-appraise have?
google/git-appraise has 5.3k GitHub stars — refresh the page for the live number, or check github.com/google/git-appraise. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What is google/git-appraise?
google/git-appraise (google/git-appraise) is a Go project on GitHub. From the project's own README: Distributed code review system for Git repos
What language is google/git-appraise written in?
google/git-appraise is written primarily in Go. GitHub's language field is based on the largest share of bytes in the default branch.
Read full README in the tab above.
Curious whether git-appraise is right for you?
Let ChatGPT, Claude, or Perplexity look into it — click below and see what AI actually says about git-appraise.