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

# GitHub

> Sync issues and pull requests from your repositories

The GitHub integration captures issues and pull requests from your repositories. It serves two purposes:

* **Issues as user feedback.** GitHub issues are treated as public submissions: bug reports, feature requests, questions, and other user-facing signals. Modem categorizes and groups them alongside feedback from your other sources.
* **Pull requests for shipping context.** Modem syncs PR metadata so it understands what your team is building and shipping. This helps the agent connect user feedback to actual product changes.

<Info>
  Modem does not read your source code. It only syncs metadata: issue and PR titles, descriptions, comments, labels, and review
  discussions. No file contents, no diffs, no repository browsing.
</Info>

## Prerequisites

* Permission to install GitHub Apps on the repositories or organization you want to connect
* A Modem organization

## Setup

<Steps>
  <Step title="Start the connection">
    Go to **Settings** → **Integrations** → **GitHub** in your Modem dashboard and click **Connect GitHub**.
  </Step>

  <Step title="Install the GitHub App">
    You'll be redirected to GitHub to install the Modem GitHub App. Choose which repositories Modem can access: - **All repositories**
    gives Modem access to all current and future repositories. - **Selected repositories** lets you pick specific ones.
  </Step>

  <Step title="Authorize access">Review the permissions and click **Install & Authorize**.</Step>
</Steps>

After installation, Modem syncs your selected repositories and begins listening for new activity via webhooks.

## What Gets Captured

### Issues

New issues are captured as they're created, along with all comments. Modem also tracks state changes (opened, closed, reopened) and labels.

When you first connect a repository, Modem backfills open issues from the last 30 days and their comments. Closed issues are not backfilled.

### Pull Requests

Modem captures PR titles, descriptions, review comments, and review status (approved, changes requested). It tracks PR lifecycle events: opened, merged, closed.

For review comments made on specific lines of code, Modem captures the comment and the small code snippet shown in the review UI. It does not access full file contents or complete diffs.

## Automations

GitHub pull request events can also trigger [automations](/features/automations) in Modem. After GitHub is connected, you can create event automations for:

* **GitHub PR Created**
* **GitHub PR Merged**

These are useful for posting shipping updates to Slack, summarizing new PRs, or linking PRs to relevant feedback topics automatically.

<Info>
  GitHub Discussions are not yet supported. Follow the [Modem blog](https://modem.dev/blog) or [X account](https://x.com/modemdev) for
  updates.
</Info>

## Choosing Repositories

### Recommended

* Your main product repositories with active issue tracking
* Repositories where users submit bug reports or feature requests
* Open-source projects with community contributions

### Consider Carefully

* Private repositories with sensitive information
* Archived or inactive repositories
* Internal tooling repositories (unless you want to track internal feedback)

<Tip>
  You can change which repositories Modem accesses anytime, either from the Modem dashboard or from your GitHub App installation settings.
</Tip>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Repository not appearing">
    * Verify the Modem GitHub App is installed for that repository - Check your GitHub App installation settings (GitHub → Settings →
      Applications → Modem) - Ensure you have permission to install apps on the repository
  </Accordion>

  <Accordion title="Missing issues or PRs">
    * Backfill syncs open issues from the last 30 days. Closed issues will be captured when they receive new activity. - Check that the
      repository is included in your GitHub App installation
  </Accordion>

  <Accordion title="Events not showing up">
    * Verify the GitHub App is properly installed - Check GitHub's webhook delivery status in your repository settings under Webhooks -
      Contact [support@modem.dev](mailto:support@modem.dev) if webhook deliveries show failures
  </Accordion>
</AccordionGroup>

## Managing Repositories

To add or remove repositories after initial setup:

1. Go to **Settings** → **Integrations** → **GitHub** in Modem
2. Click **Manage Repositories** to update your selection

You can also manage this directly from GitHub under Settings → Applications → Modem → Configure.

## Coding Agents

If you've configured [coding agents](/integrations/coding-agents), they use your connected GitHub repositories as targets for implementation tasks. The GitHub integration must be connected for coding agents to work on repositories.

## Disconnecting

To disconnect GitHub:

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

To fully remove the Modem app from your GitHub account or organization:

1. Go to GitHub Settings → Applications
2. Find Modem and click **Configure** → **Uninstall**

Historical data remains in Modem after disconnecting.