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

# GitHub

The **GitHub connection** lets you integrate external GitHub repositories directly into your SeaTicket workspace. Once connected, SeaTicket automatically syncs GitHub Issues and uses AI to generate summaries for each issue, helping your team manage bugs, feature requests, and tasks alongside other inquiries in a single unified interface.

## Before You Start

Ensure you have:

* A GitHub account with admin or owner permissions for the organization or repository you want to connect.

## Creating a GitHub Connection

### Step 1 — Install the GitHub App

1. Go to **Connections** in the left sidebar.
2. Click **+ New Connection**.
3. Select **GitHub** as the connection type.
4. Click **Install GitHub App**. You'll be redirected to GitHub.

<Frame>
  <img src="https://mintcdn.com/seacloud-labs/WcHiqSPczPbRTQJs/images/image-332.png?fit=max&auto=format&n=WcHiqSPczPbRTQJs&q=85&s=2368363a72a6c67ef66eec89de9cde3c" alt="Image" width="1911" height="847" data-path="images/image-332.png" />
</Frame>

5. On GitHub, select the organization or personal account that hosts your repository.

<img src="https://mintcdn.com/seacloud-labs/P273-RPgjYaMnI7f/images/image-248.png?fit=max&auto=format&n=P273-RPgjYaMnI7f&q=85&s=150665822cb52c0730f02df4f32663c5" alt="Image" width="1219" height="476" data-path="images/image-248.png" />

6. Under **Repository access**, select **Only select repositories** and choose the specific repositories SeaTicket should have access to.

<Frame>
  <img src="https://mintcdn.com/seacloud-labs/WcHiqSPczPbRTQJs/images/image-306.png?fit=max&auto=format&n=WcHiqSPczPbRTQJs&q=85&s=fd2e82b4d765d02d4be2a3bf6ea03f2b" alt="Image" width="1203" height="696" data-path="images/image-306.png" />
</Frame>

7. Review the requested permissions — SeaTicket requires **Read access to metadata** and **Read and write access to issues**.
8. Click **Update access** to finalize the authorization

<Frame>
  <img src="https://mintcdn.com/seacloud-labs/WcHiqSPczPbRTQJs/images/image-311.png?fit=max&auto=format&n=WcHiqSPczPbRTQJs&q=85&s=a2fed5cddfa3a6b79f8670f6d83b9540" alt="Image" width="1217" height="692" data-path="images/image-311.png" />
</Frame>

### Step 2 — Configure the Connection in SeaTicket

After authorizing on GitHub, you are returned to SeaTicket automatically.

1. Enter a descriptive **Connection name**.
2. Select the **Repository** you just authorized from the dropdown.
3. Click **Submit** to complete the setup.

<img src="https://mintcdn.com/seacloud-labs/P273-RPgjYaMnI7f/images/image-251.png?fit=max&auto=format&n=P273-RPgjYaMnI7f&q=85&s=e1043abc47c046ea85111974f4d0320e" alt="Image" width="1900" height="803" data-path="images/image-251.png" />

### After the Connection is Created

Once connected, SeaTicket automatically syncs GitHub Issues, which appear in a list view under the connection in the left sidebar, organized into **Open** and **Closed** tabs.

* Issues are displayed in a list view
* Updates are synced automatically **every 1 hour**
  Updates sync every hour.

<Frame>
  <img src="https://mintcdn.com/seacloud-labs/P273-RPgjYaMnI7f/images/image-252.png?fit=max&auto=format&n=P273-RPgjYaMnI7f&q=85&s=9d2f841b01980b1ca22d812ac81caa03" alt="Image" width="1891" height="798" data-path="images/image-252.png" />
</Frame>

For each issue, SeaTicket records:

* Title
* State (Open / Closed) and State reason
* Labels
* Author
* Created time, Last modified time, and Closed time
* Total comments including all discussion threads
* AI Summary and AI Processed time — automatically generated for each issue

## Viewing Details

After data has been synced, click any issue title to open the full issue view inside SeaTicket, including all comments and discussion history in chronological order.

<Frame>
  <img src="https://mintcdn.com/seacloud-labs/VpSMHVL7sZs2hr1x/images/image-267.png?fit=max&auto=format&n=VpSMHVL7sZs2hr1x&q=85&s=fc57c1f40879fbeb4776483f2fae563c" alt="Image" width="1800" height="821" data-path="images/image-267.png" />
</Frame>

You can also click the external link icon next to the issue title to open it directly on GitHub.

<Frame>
  <img src="https://mintcdn.com/seacloud-labs/VpSMHVL7sZs2hr1x/images/image-275.png?fit=max&auto=format&n=VpSMHVL7sZs2hr1x&q=85&s=abf60b77d212c361780fc9f7630d7686" alt="Image" width="1889" height="884" data-path="images/image-275.png" />
</Frame>
