Skip to main content

Managing Git Integrations

Manage Git integrations in LinearB, including connected repositories, monitoring rules, reauthorization, and gitStream connections.

Steven Silverstone
Updated by Steven Silverstone

From Settings → Company Settings → Git, you can view and manage all Git integrations connected to your LinearB account. Expand an integration to view discovered and monitored repositories, search and filter repositories, monitor or unmonitor them, and manage the integration.


Summary
  • View all Git integrations and repository monitoring counts.
  • Search and filter discovered repositories.
  • Monitor or unmonitor repositories directly from the Git integration page.
  • Reauthorize, configure monitoring rules, or delete existing integrations.
  • Manage gitStream connections.
  • Add new Git integrations at any time.

Managing an integration
  1. Go to Settings → Company Settings → Git.
  2. Under Integrations and Repositories, locate the integration you want to manage.
  3. Click the integration row to expand its details.
  4. Click the vertical ellipsis (⋮) to access available actions:
    • Reauthorize Git — Refresh authentication if the token expired or permissions changed.
    • Monitoring Rules — Control which repositories, pull requests, or branches LinearB monitors.
    • Delete Integration — Permanently remove the integration.

Managing monitored repositories

Expand a Git integration to view all discovered and monitored repositories. From this view, you can search, filter, monitor, or unmonitor repositories without leaving the page.

The integration header displays the number of monitored repositories, the total number of discovered repositories, and the integration's current gitStream connection status.

  1. Go to Settings → Company Settings → Git.
  2. Under Integrations and Repositories, expand the Git integration you want to manage.
  3. Use Search, the State filter, or the Visibility filter to locate repositories.
  4. Select one or more repositories using the checkboxes.
  5. Optionally, click Select all matching repositories to select every repository that matches the current filters.
  6. Click Monitor to begin monitoring the selected repositories, or Unmonitor to stop monitoring them.
Combine Search, State, and Visibility filters to quickly locate repositories. You can clear your current selection at any time.
Repositories in the Discovered state have been detected by LinearB but are not yet monitored. Select the repositories and click Monitor to begin collecting engineering activity.

Recovering failing repositories

If a repository enters a Failing state, recover it directly from the Git integration page.

After recovery starts, the repository moves to Processing. If processing completes successfully, the repository returns to Monitored.

For detailed instructions, see Recover a Failing Repository.


Managing gitStream connections

If an integration is connected to gitStream, the integration header shows a connected to gitStream status.

  • Click Disconnect gitStream to unlink it from the integration.
  • You can reconnect later by reconfiguring gitStream from the integration settings.

Adding a new Git integration
  1. Click Add Integration in the upper-right corner.
  2. Select your Git provider, such as GitHub or GitLab.
  3. Follow the on-screen steps to authenticate and grant access.

Deleting a Git integration

Admins can permanently remove a Git integration.

If the integration contains associated data, such as repositories, metrics, gitStream connections, or historical activity, deletion requires confirmation. If no data exists, deletion completes immediately.

  1. Go to Settings → Company Settings → Git.
  2. Select the integration to expand its details.
  3. Click the vertical ellipsis (⋮) and choose Delete Integration.
  4. Select a deletion option:
    • Remove everything — Permanently deletes the integration and all associated data.
    • Keep data — Removes the integration but preserves existing data in LinearB. Data remains visible, but no new updates are pulled.
  5. Click Next, then Delete to confirm.
If your organization has only one Git integration, deletion is disabled. At least one active Git integration is required.

Need help?
Visit the LinearB Support Page .

How did we do?

Installing a GitHub Organization-Level Webhook

Contact