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

# GitHub

> Sync GitHub issues as Feedback in Kontext.

## Setup

1. Go to **Organization Settings → Integrations**
2. Click **Connect GitHub**
3. Install the Kontext GitHub App on your organization or selected repositories
4. Choose which repositories to sync

## What gets synced

* **Issues** — each issue becomes a [Feedback](/concepts/feedback) entry in Kontext
* **Labels, assignees, and metadata** are preserved for reference
* **Releases** are synced to generate a Release in Kontext

<Note>
  Issue comments are not synced at this stage. In some repositories, comments may not add
  to the original issue detail and would dilute the analysis. We're working on a
  pre-filtering step to separate signal from noise before syncing comments. [Let us
  know](https://kontext.featurebase.app) if comment syncing is important to your
  workflow.
</Note>

## Sync behavior

* **Initial sync** — imports existing open issues from selected repositories
* **Ongoing sync** — new issues and updates are synced via webhooks in real-time
* **Bi-directional** — Problems detected in Kontext are linked back to GitHub issues

## Configuration options

| Option        | Description                                          |
| ------------- | ---------------------------------------------------- |
| Repositories  | Select which repos to sync                           |
| Label filters | Optionally limit sync to issues with specific labels |
| Auto-sync     | Enable/disable webhook-based real-time sync          |