# GitHub

Reference pull requests and issues in your posts

Connect your GitHub account to Cushion to seamlessly reference pull requests, issues, and track development activity alongside your team updates.

## Features

- **Reference Pull Requests** - Link to and display PR details directly in your posts
- **Track Issues** - Create and reference GitHub issues from within Cushion
- **Activity Sync** - Keep your team informed about development progress
- **Repository Selection** - Choose a default repository for your team

## How to Enable

1. Navigate to your team **Settings**  
2. Select the **Integrations** tab  
3. Click **Enable** next to GitHub  
4. You’ll be redirected to GitHub to authorize the connection  
5. Grant Cushion access to your repositories  
6. Select your default repository for the team

## Permissions Required

When you connect GitHub, Cushion requests the following OAuth scopes:

- `repo` - Access to your repositories (required for PR and issue tracking)
- `admin:repo_hook` - Manage repository webhooks for real-time updates

## Using the Integration

Once connected, you can:

- Mention PRs and issues using `#` followed by the issue/PR number  
- Create new GitHub issues directly from Cushion posts  
- View PR status and activity in your team feed

## Disconnecting

To disconnect GitHub:

1. Go to team **Settings** → **Integrations**  
2. Click **Disconnect** next to GitHub

This removes the link but won’t affect your GitHub repositories.