Skip to main content

Step 3: Add Repositories

After installing the GitHub App, you need to add repositories in diffray to activate reviews.

Why Add Repositories?​

Even if the GitHub App is installed and has access to your repositories, you need to explicitly authorize each repository in the diffray dashboard. This is an additional level of control that allows you to:

  • Choose specific repositories for AI reviews
  • Track statistics per repository
  • Disable reviews for certain repositories without uninstalling the App

Adding a Repository​

Step 1: Open Repositories Section​

  1. Log into the diffray dashboard
  2. Select "Repositories" from the navigation menu

Step 2: Check GitHub App Status​

On the page you'll see:

  • List of your organizations with App installation indication
  • Number of App installations (e.g.: "GitHub App installed on 2 accounts")
  • Your already added repositories

Step 3: Add a Repository​

  1. Click "+ Add Repository" button

  2. A modal window will open with a list of available repositories

  3. You'll see:

    • Number of repositories found
    • Search field for filtering
    • List of repositories with "Add" button

  4. Find the needed repository via search (if you have many repositories)

  5. Click "Add" next to the desired repository

  6. After successful addition, the repository will appear in the authorized list

Repository Information​

For each added repository displayed:

  • Full name (owner/repo)
  • Privacy status (Private/Public)
  • Owner - repository owner
  • Date added - when repository was authorized
  • "Remove" button to remove from authorized

Don't See Your Repository?​

If the needed repository doesn't appear in the list:

Reason 1: GitHub App Not Installed​

Solution:

  1. Check the "Your Organizations" section on the same page
  2. If there's no "App Installed" checkmark next to the needed organization, click "Install App"
  3. Or install directly: https://github.com/apps/diffray/installations/select_target
  4. After installation, click "Refresh" in the modal window

Reason 2: Repository Not Selected in App Settings​

Solution:

  1. Go to GitHub: Settings → Applications → Installed GitHub Apps → diffray
  2. Click "Configure"
  3. Add the needed repository to the accessible list
  4. Return to diffray and click "Refresh"

Reason 3: Caching​

Solution:

  1. In the "Add Repository" modal window, click "Refresh" button
  2. Wait a few seconds while repositories load
  3. If it doesn't help, reload the browser page

Removing a Repository​

If you no longer want to receive reviews for a certain repository:

  1. Find the repository in the authorized list
  2. Click "Remove" button on the right
  3. Confirm removal in the dialog box

Important: When removing a repository:

  • diffray will no longer be able to receive webhooks from this repository
  • All old reviews will remain in history
  • GitHub App will continue to have access (unless removed through GitHub settings)

Working with Private Repositories​

diffray fully supports private repositories through GitHub App:

  • Private repositories are marked with "Private" label
  • No additional settings required
  • Works the same as public repositories

Batch Management​

Adding Multiple Repositories​

Add repositories one by one via the "Add" button - this allows conscious control of where reviews are active.

Viewing All Repositories​

All your authorized repositories are displayed on the main Repositories section page.

After Adding​

After successfully adding a repository:

  1. diffray is ready to work with this repository
  2. Next step: Create Pull Request
  3. When opening a new PR, a review will automatically start

Managing Organization Repositories​

If you work with organization repositories:

Who Can Add Repositories?​

  • Any organization member who has authorized in diffray
  • GitHub App must be installed by organization administrator
  • Each user manages their authorized repositories independently

Shared Reviews​

If multiple people from the organization added the same repository:

  • Reviews will run on behalf of the user who registered the webhook (usually the first one who added it)
  • Each user spends their review limits
  • Comments are posted through GitHub App on behalf of "diffray"

Next step: Create Pull Request and get your first AI review →