Pull Assigner

Getting started with Pull Assigner

Pull Assigner automatically assigns code reviews so that reviews are evenly split across the team, making your code review process more balanced and efficient.

Pull Assigner works using GitHub Teams. When you request a review from a GitHub Team that has Pull Assigner enabled, the Pull Assigner bot automatically assigns individuals from the team as reviewers.

To use Pull Assigner, you need to:

  1. Organize reviewers into GitHub teams.

  2. Enable Pull Assigner for each team.

  3. Request pull request reviews from GitHub Teams or automate it with CODEOWNERS.

Example Workflow

Say you have a team called "Backend Developers" with two members, John and Kelly. You configure Pull Assigner to assign one reviewer whenever the team is requested. When someone requests a review from "Backend Developers", Pull Assigner will automatically assign John. Then on the next pull request, Pull Assigner will assign Kelly, and so on.

Setup tips

If you currently request reviews from GitHub Teams... enable Pull Assigner for the GitHub Teams you already request reviews from.

If you currently request reviews from users... first organize your team into GitHub Teams based on your review process. For example, if you want to assign reviews to one junior developer and one senior developer, you could create two teams, Junior Developers and Senior Developers. Or you might create teams based on function, eg. Frontend Developers and Backend Developers. Enable Pull Assigner for each of your teams and consider using CODEOWNERS to automatically assign teams to pull requests.

If you currently leave reviews open for your entire team... create a GitHub Team with your entire team as members. Enable Pull Assigner for each of your teams and consider using CODEOWNERS to automatically assign teams to pull requests.

Pull Reminders Slack DM notifications are automatically muted for team review requests where Pull Assigner is enabled. For muting GitHub email notifications, we recommend setting up an email filter.