Skip to main content
This guide walks through a review from the inbox to a submitted verdict.
1

Connect your repositories

Sign in with GitHub, install the Assert GitHub App, and choose your organization’s repositories and workspace. For personal repositories, install the app on your GitHub account and choose your personal workspace.If you can’t install the app, use Review locally. Run npx assert-local@latest review, select a repository, and keep the terminal running while you review.
2

Pick a pull request from the inbox

Open Inbox in the sidebar. Needs action lists pull requests waiting on you; Waiting on others lists ones waiting on your teammates.Choose a pull request in Needs action. If your inbox is empty, use Pull requests in the sidebar to find one in your workspace.
3

Review one cluster at a time

Choose a cluster from the Clusters sidebar. Each cluster has a summary and its related changes. Press R to mark code reviewed.For visual changes, open UI previews to try the components. See Reviewable units for more on clusters.
4

Comment and submit

Select code and press ⌘K to comment, or ⌘I to suggest an edit. Choose Add To Review to keep the comment pending until you submit.To submit, open Finish review in the header (or Review if you haven’t left comments), add a summary, choose a verdict, and choose Submit Review.
5

Next steps

Return to Inbox for your next review. When the author pushes new commits, use re-review to see what changed.You can also send feedback to a cloud agent and review its fix on the same PR.
Press G, then ? for shortcut help, or see the keyboard reference.