This article describes how to integrate a GitHub repository so that Commet can index and analyze the issues and pull requests to let you text search them.

There are two ways to achieve this. One is to link your account to GitHub using OAuth2 and allow Commet to import the issues and pull requests on your behalf. The other is to create an incoming webhook endpoint on Commet and have GitHub use it.

OAuth2

Here are the steps:

1. Link your account to GitHub (if it isn’t already).
2. Grant “repo” scope to Commet.
3. Choose a repository that you want to integrate from the GitHub Integration Settings page.

Link your account to GitHub

If you’ve signed up with GitHub, you can skip this step.

1. Choose “User Settings” from the drop down menu in the top right corner.
2. Click on “External Accounts” in the left menu.
3. Click on the “Link” button for GitHub.

Grant “repo” scope to Commet

1. Choose a team that you want to integrate with a GitHub repository from the drop down menu at the top.
2. Choose “Integrations” from the “Manage Team” drop down menu.
3. Click on “GitHub” under “API” in the left menu.
4. Click on the “Grant ‘repo’ Permission” button.

Choose a repository that you want to integrate

On the same page, follow the steps below:

1. If you don’t see any repositories in the drop down menu, click on the refresh icon next to the drop down.
2. Choose a repository.
3. Click on the “Add” button.

The background program on Commet will start importing the issues and pull requests within 5 minutes.

Webhook

TODO