Skip to main content
The Assert GitHub App gives Assert access to your team’s pull requests and keeps reviews in sync with GitHub as authors push changes and teammates comment.

​
Install the app

  1. During Assert setup, choose Install GitHub App, or open Assert App on GitHub and choose Install.
  2. Select your organization and the repositories you want to review.
  3. Return to Assert and choose the organization as your workspace.
For repositories on your personal GitHub account, select your account instead of an organization in step 2, then return to Assert and choose your personal workspace. You can manage this installation in Account settings → GitHub access. If an administrator needs to approve the installation, you can review locally in the meantime.

​
Find pull requests

Open Inbox and choose a pull request under Needs action. It lists reviews waiting on you and updates on pull requests you’re involved in. Waiting on others lists pull requests waiting on someone else. To find a pull request that isn’t in your inbox, open Pull requests in the sidebar. See the quickstart for a walkthrough of a review.

​
Syncing with GitHub

Comments, suggestions, and review verdicts you submit in Assert are posted to GitHub. Pending comments stay in your draft until you submit the review.

​
Manage access

Use Team settings to manage an organization’s app installation, and choose its repository access on GitHub. Personal installations are under Account settings → GitHub access. If a repository is missing, check that the installation includes it and that your linked GitHub account has access.

​
Other ways to connect

The GitHub App is the recommended setup. If you can’t install it, use assert-local with your GitHub CLI account. Personal access tokens are also supported.