plz.review docs
  • 😎What is plz.review?
  • ⚡Quick Start
  • Fundamentals
    • 💫How to plz
    • 💅Web UI Basics
    • 🖥️CLI Basics
    • 📚Playbook
    • 🎹Keyboard Shortcuts
    • 🎮CLI User Guide
      • Creating reviews
      • Stacking reviews
      • Merging reviews
      • Amending reviews
  • Support
    • 💌Contact Us
    • 🔬Known Issues
  • Security & Policies
    • 🔐Security
      • GitHub
      • Slack
      • Policies & Compliance
      • Privacy Policy
      • Terms of Use
Powered by GitBook
On this page
  • Signing in
  • Installing the plz.review GitHub application
  • Installing the plz CLI
  • Auth your GitHub account

Quick Start

PreviousWhat is plz.review?NextHow to plz

Last updated 2 years ago

Signing in

Navigate to and use the Sign in button. You’ll be taken to GitHub to complete the OAuth process.

Installing the plz.review GitHub application

In order to use plz for PRs in your organization’s repos, you’ll need to install our .

Click your username or the org having the repo(s) where you want to use plz. You can then choose to install on all the repos, or select them individually. If you have sufficient permissions you can click the Install button to complete the process. Otherwise you will need ask an administrator for the repo(s) by clicking Request.

For details on the permissions plz requires, please check out our document.

Once you’ve auth’d your GitHub account and installed the GitHub app, you’re ready to roll. The app will append a message to any new PRs opened in your repos with a link to our app for reviewing those PRs. See more about

If you are using plz for stacked reviews, we recommend updating your repository settings to enable "Automatically delete head branches" in the Pull Requests section of your repo's General settings.

Find in "General Settings" on your repo

Installing the plz CLI

macOS

If you use Homebrew, you can add the Bit Complete tap and install plz:

brew tap bitcomplete/tap
brew install plz

Linux

Auth your GitHub account

Once installed, you'll need to run plz auth so that the CLI has permission to talk to GitHub on your behalf. Follow the instructions to enter the provided OTP code in a browser for GitHub.

There’s more to plz than a web interface. It can also help you manage a workflow that encourages incremental, or “stacked,” PRs. This concept is familiar from tools like Phabricator and Gerrit. To use plz as a way to create reviews / PRs, you’ll need to install .

Alternatively you can download an archive containing a binary for your architecture on the page.

Download an archive containing a binary for your architecture on the page.

⚡
the CLI
plz CLI releases
plz CLI releases
plz.review
app on GitHub
Security & Compliance
"Using Plz Review for reviewing code only."
image.png
image.png