GitHub Connections

Note: Codebase Search currently does not handle large numbers of repositories well. Improving this integration is on our roadmap.

GitHub connections enable agents to access your repositories for codebase context during investigations, and ingest GitHub events (pushes, pull requests, workflow runs, etc.).

Recommended: Create and manage connections via the web UI at https://ui.{deployment}.firetiger.com/settings/connections

Installation

  1. Navigate to Settings > Connections in the Firetiger UI
  2. Click New Connection
  3. Select GitHub as the connection type
  4. Click Connect GitHub
  5. You will be redirected to GitHub to authorize the Firetiger GitHub App
  6. Select the GitHub organization or user account where you want to install the app
  7. Choose which repositories to grant access to (all repositories or select specific ones)
  8. Confirm the installation

The connection will be created automatically with your GitHub account details. GitHub will automatically send webhook events to Firetiger for the selected repositories.

What Gets Created

When you install the GitHub app, Firetiger automatically creates a connection with:

Field Value
connection_id github-{installation_id}
display_name Your GitHub organization or user name
description GitHub: {account_name}

Permissions

The Firetiger GitHub App requests the following permissions:

Permission Access Purpose
Repository contents Read Access code for context during investigations
Metadata Read Basic repository information
Pull requests Read PR details and status
Actions Read Workflow and job information

Updating Repository Access

To add or remove repositories from your GitHub connection:

  1. Navigate to the Firetiger GitHub App page
  2. Click Configure
  3. Select your GitHub organization or user account
  4. Under Repository access, choose:
    • All repositories - Grant access to all current and future repositories
    • Only select repositories - Choose specific repositories to grant access to
  5. Click Save

Changes take effect immediately. Firetiger will automatically update the available repositories for codebase search.

Re-authorization

To reconnect or fix authentication issues:

  1. Navigate to Settings > Connections in the Firetiger UI
  2. Find your GitHub connection
  3. Click Reconnect or delete and recreate the connection

Capabilities

GitHub connections enable:

  • Codebase context - Agents can search and read repository code during investigations
  • Event ingestion - Automatic ingestion of GitHub events (pushes, PRs, workflow runs)
  • Repository insights - Activity tracking and change history

Description Field

The description field helps agents understand which repositories and use cases this connection covers.

Example:

Production infrastructure repositories.

Key repositories:
- firetiger-inc/core - Main application code
- firetiger-inc/infra - Terraform and deployment configs
- firetiger-inc/docs - Documentation

Use for investigating deployment issues, code changes, and CI/CD failures.

Best Practices

  • Limit repository access - Only grant access to repositories that agents need for investigations
  • Use descriptive names - Helps agents select the right connection when multiple GitHub accounts are connected
  • Document repository purposes - Include which repositories are relevant for different investigation types

GitHub App Page

The Firetiger GitHub App is available at: https://github.com/apps/firetiger-agent

This site uses Just the Docs, a documentation theme for Jekyll.