> For the complete documentation index, see [llms.txt](https://alhena.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alhena.gitbook.io/docs/integrations/communication/integrating-alhena-ai-with-github.md).

# GitHub

Connect Alhena to your GitHub organization to provide AI-powered responses to discussions in your repositories.

## Prerequisites

* A GitHub account with admin access to your organization
* Repositories where you want to enable Alhena

## Setup

1. In Alhena, go to **Settings > Integrations**
2. Find **GitHub** and toggle it on
3. You'll be redirected to GitHub to install the Alhena app
4. Select your organization
5. Choose which repositories to enable

Once connected, you can configure settings in the integration.

***

## How It Works

When enabled for a repository, Alhena can:

* Monitor new discussions
* Provide AI-generated responses based on your documentation and training
* Help answer common questions from your community

***

## Repository configuration

After connecting, each enabled repository is configured individually. From the GitHub setup page, select a repository to open its **Repository Settings**. Repositories that haven't been set up yet show **Complete Setup**; once configured, they show **Configure Settings**.

On the repository settings page you can control the following:

* **Allow Alhena to comment on discussions** — a toggle that enables or disables Alhena responding to discussions in this repository. While off, the rest of the settings are disabled.
* **Audience** — a dropdown that controls whose discussions Alhena will respond to:
  * **Everyone**
  * **All but maintainers**
  * **Only maintainers**
  * **None**
* **Discussion categories** — a multi-select listing your repository's discussion categories ("Select labels to which Alhena should respond"). Alhena only responds to discussions in the categories you select here.

You must select at least one discussion category for the repository to count as configured. Click **Save changes** to apply your settings.

***

## Disconnecting

GitHub cannot be disconnected from within Alhena. To remove the integration:

1. Go to your GitHub organization settings
2. Navigate to **Installed GitHub Apps**
3. Find Alhena and uninstall or configure access