# Configure with GitHub

<figure><img src="/files/IhucR3JRADBUMlYf80ye" alt="github"><figcaption></figcaption></figure>

After successfully authenticating, you will be redirected into your private Baz workspace. Select `Connect to GitHub` to select which organization and repositories you would like to integrate with Baz.&#x20;

*Note: If your GitHub admin already integrated your organization, you will be able to select it from the organization navigation menu.*

## **Install Baz Review GitHub App**

You will be redirected to the GitHub app installation page. Select the organization or user account where you want to install the Baz GitHub app. Choose the repositories that Baz should access and click the **Install** button to complete the installation.

<figure><img src="/files/CMkPhUHIVPakVjl29aFz" alt="" width="375"><figcaption></figcaption></figure>

That's it. You've succusfuly installed Baz. You will now be redirected back to Baz to see your Code and open Changes.&#x20;

## Write Access GitHub App

Baz allows an elevated permission set, including write access to repo contents and interacting with PRs via Baz UI and Baz CLI. For that we need to install the **Baz-app** GitHub app. For more details - skip to the [Permission Model](#permission-model) section below

You may start this flow from the configurations page, or by [visiting this link](https://github.com/apps/baz-app/installations/select_target). It will install the Baz-app GitHub app which includes write access to the relevant repos you select. It will look like this (notice the different scope of the app versus baz-review app):

<figure><img src="/files/2292KJn0VMn9kdfK3mGV" alt="" width="563"><figcaption></figcaption></figure>

This app allows the functionality of:

1. Baz Fixer
2. Auto-resolving addressed comments
3. Approving PRs with write access
4. User interactions via baz UI. This will require a second set of per-user installations as can be seen here:<br>

   <figure><img src="/files/GB09b8CY0nKTlAi3XtZq" alt="Personal installation of Baz-app" width="401"><figcaption></figcaption></figure>

## Permission Model

Baz supports a two-level permission model.

### Baz Reviewer

The Baz Reviewer app requires only the permissions necessary to review pull requests:

* Read access to repository code
* Write access to PR comments
* Permission to create GitHub checks

This allows Baz to review PRs and provide feedback without modifying repository code.

### Baz-app

Some workflows require write access to repository code, such as:

* Auto-approve PRs
* Auto-resolve findings
* Automated code fixes

For teams that want these capabilities, Baz provides a separate app with elevated permissions.

## Reconfiguring

At any point, you can go back and reconfigure GitHub by going to your Integrations Page. Click the `Configure` button to connect Baz to configure the baz-reviewer app, and click the `Configure write access` for that specific account to configure the baz-app app. Both of these links will redirect you to GitHub’s authorization page for the relevant app. If you aren’t logged in, log in to your GitHub account. Once logged in, you will see a permission request page where Baz requests access to your account. Review the permissions and click the **Authorize Baz** button to grant access.

## FAQ

<details>

<summary><strong>How do I connect Baz to my GitHub repositories?</strong></summary>

You will authorize Baz via GitHub’s OAuth or an app integration, selecting which repos Baz may access. Once connected, Baz will monitor pull requests in those repos.

</details>

<details>

<summary><strong>Can I restrict Baz to only certain folders or repos?</strong></summary>

Yes. You can scope Baz’s reviews to specific repositories or folders so it doesn’t run everywhere by default.

</details>

<details>

<summary><strong>How is Baz triggered on pull request events?</strong></summary>

Baz listens to PR events (open, updates, commits pushed) and can be configured to re-review on new pushes, dismissals, or resolution of comments.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.baz.co/basics/configure-with-github.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.