GitHub Integration

Available

Connect your GitHub repositories to OpsBrief and receive AI-powered daily digests of issues, pull requests, releases, and deployments.

What OpsBrief Tracks

Pull Requests

Track PR opens, merges, reviews, and comments. Know when code is ready for review or deployed.

Issues

Monitor new issues, status changes, assignments, and resolutions across your repositories.

Releases

Get notified about new releases, tags, and version updates with release notes summaries.

Deployments

Track deployments to different environments. See who deployed what and when.

Prerequisites

A GitHub account with access to the repositories you want to monitor
Organization admin permissions (for organization repositories) or repository admin access
An OpsBrief account (sign up free)

Step-by-Step Setup

Navigate to Integrations

After creating your account, go to your dashboard and navigate to Settings → Integrations. You'll see GitHub in the list of available platforms.

Click Connect GitHub

Click the "Connect" button next to GitHub. This will redirect you to GitHub's app installation page where you'll install the OpsBrief GitHub App on your account or organization.

Security note: We use a GitHub App (not OAuth) for better security controls. You can select exactly which repositories to grant access to. Learn more about our security practices.

Install the GitHub App

On GitHub's installation page, choose which repositories OpsBrief can access:

All repositories - Monitor all current and future repos
Select repositories - Choose specific repos to monitor

Click "Install" to complete the installation. You'll be redirected back to OpsBrief.

Select Repositories to Monitor

After installation, navigate to Channels in your OpsBrief dashboard. You'll see all repositories the GitHub App has access to. Select which ones to actively monitor.

For engineering teams, we recommend monitoring your main product repositories, infrastructure repos, and any deployment-related repos.

Configure Event Types

For each selected repository, choose which events to track:

Product Repository

✓ Pull requests (opened, merged, reviewed)
✓ Issues (opened, closed, labeled)
✓ Releases (published)
✓ Deployments

Infrastructure Repository

✓ Pull requests (merged only)
✓ Deployments
✓ Releases
○ Issues (optional)

Permissions Explained

The OpsBrief GitHub App requests the following permissions:

Metadata (Read)

Basic repository info like name, description, and visibility

Issues (Read)

Read issue titles, descriptions, labels, and status

Pull Requests (Read)

Read PR titles, descriptions, reviews, and merge status

Contents (Read)

Read release notes and deployment configurations

Deployments (Read)

Track deployment status and environments

Troubleshooting

I don't see my repositories

Make sure you've installed the GitHub App on the correct organization or account. For organization repos, you need admin permissions. You can modify which repos the app has access to in your GitHub settings under Applications → Installed GitHub Apps.

Events aren't showing up

GitHub events sync every few minutes. If you've just connected, wait a few minutes and refresh. Also verify that the repository is selected in your OpsBrief Channels page.

Can I monitor private repositories?

Yes! When installing the GitHub App, you can grant access to private repositories. OpsBrief only reads data you explicitly allow access to.

How do I add more repositories later?

Go to GitHub Settings → Applications → Installed GitHub Apps → Configure (next to OpsBrief). You can add or remove repository access at any time.

Ready to connect GitHub?

Start receiving AI-powered digests of your GitHub activity in minutes.

OpsBrief uses artificial intelligence to analyze repository activity and extract key events. AI-generated content may occasionally be inaccurate or incomplete. We recommend reviewing extracted events and verifying important information with the original source.