> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tierzero.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

> Code repository and collaboration platform

## Overview

Connect your GitHub organization to give TierZero access to your repositories, commits, deployments, and pull requests. TierZero uses GitHub to correlate code changes with incidents, analyze recent deployments, and generate fix PRs.

## Prerequisites

* Administrative access to your GitHub organization
* Permission to install GitHub Apps

## Setup Instructions

### Step 1: Navigate to Integration Settings

1. Log into your TierZero dashboard
2. Go to **Settings → Integrations**
3. Click **Connect** next to GitHub

### Step 2: Install the GitHub App

1. Click **Install on GitHub**
2. Select your GitHub organization
3. Choose repository access:
   * **All repositories**: Access all current and future repositories (recommended for comprehensive coverage)
   * **Only select repositories**: Grant access to specific repositories

### Step 3: Complete Installation

1. Review the permissions and click **Install**
2. You'll be redirected back to TierZero
3. The integration should now show as connected

## Permissions

The TierZero GitHub App requests:

### Read Access

* **Actions**: View workflow run results and logs
* **Checks**: View check suite and check run results
* **Code**: Read repository contents, commits, and branches
* **Commit statuses**: View commit status checks
* **Deployments**: View deployment history and status
* **Metadata**: Access basic repository information

### Read and Write Access

* **Pull requests**: Read PR details and discussions, create fix PRs and post review comments

## What TierZero Accesses

* **Repository contents**: Code files, directory structure
* **Commit history**: Recent commits, diffs, and authors
* **Deployment history**: Deploy timestamps, environments, and status
* **Pull requests**: Open PRs, review comments, CI check results
* **GitHub Actions**: Workflow run logs and results
* **Repository list**: Available as imported repository context

## Integration Resources

After connecting GitHub, your repositories are automatically cataloged for TierZero to use during code-aware investigations.

## Modifying Access

You can change which repositories TierZero has access to at any time:

1. Go to your GitHub organization's **Settings → GitHub Apps**
2. Click **Configure** next to TierZero
3. Update repository access
4. Changes take effect immediately

## Security

* TierZero uses the GitHub App model (not personal access tokens)
* Read-only access to everything except pull requests
* Access can be revoked at any time from GitHub's app settings
* Installation-scoped tokens with minimal permissions

## Troubleshooting

### Repository Not Visible

* Verify the repository is included in the GitHub App's repository access settings
* If using "Only select repositories," add the missing repository

### "Not Found" Errors

* The GitHub App may not have access to the repository
* Check that the app is still installed on your organization