Skip to main content
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.
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.

​
Prerequisites

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

​
Setup

1

Start the connection

Go to Settings → Integrations → GitHub in your Modem dashboard and click Connect GitHub.
2

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.
3

Authorize access

Review the permissions and click Install & Authorize.
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 your open issues 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.
GitHub Discussions are not yet supported. Follow the Modem blog or X account for updates.

​
Choosing Repositories

  • 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)
You can change which repositories Modem accesses anytime, either from the Modem dashboard or from your GitHub App installation settings.

​
Troubleshooting

  • 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
  • Backfill only syncs open issues. Closed issues will be captured when they receive new activity.
  • Check that the repository is included in your GitHub App installation
  • Verify the GitHub App is properly installed
  • Check GitHub’s webhook delivery status in your repository settings under Webhooks
  • Contact support@modem.dev if webhook deliveries show failures

​
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 (Cursor or Devin), they use your connected GitHub repositories as targets for implementation tasks. The GitHub integration must be connected for coding agents to work.

​
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.