On this page

Github AI Integration

Integrate Statsig with GitHub AI tools to keep feature gates and experiments visible to AI code reviewers and automate flag cleanup PRs.

How the GitHub AI integration works

This feature is in open beta and might have rough edges. If you have feedback, share it with the Statsig team.

The Statsig GitHub integration links your organization's code repository directly to your Statsig project. Statsig analyzes your codebase and creates a private Knowledge Graph that maps relationships between your codebase and Statsig services such as Feature Gates, Experiments, and Metrics.

This integration connects your software development with measurable business impact, delivering contextual insights within Statsig.

Knowledge Graph diagram showing relationships between codebase and Statsig services

Key features

Integrating your code repository unlocks the following capabilities:

  • Locate specific lines of code where a Feature Gate or Experiment is implemented
  • Automatically generate PRs (Pull Requests) to remove stale flags from your code

An example of Remove from Code in a stale gate banner

  • Understand the intent behind metrics and experiments based on code implementation

An example of AI description in the right rail of a config

  • Write natural language queries to create charts to answer business questions (Coming Soon)

Why connect your codebase

In modern product development, there is often a disconnect between the code you write (hosted on GitHub) and its impact and business outcomes (data in Statsig). The Knowledge Graph bridges this gap by analyzing your connected repositories to provide the context behind every feature.

  • Context: The Knowledge Graph knows when an event is logged or a feature is exposed to a user.
  • Intent: The Knowledge Graph understands the purpose and meaning of that event and feature.
  • Freshness: The Knowledge Graph ensures insights in Statsig reflect the current state of your main branch.

Installation guide

Before you begin, confirm you have Admin permissions in both your Statsig Project and the target GitHub Organization.

Prerequisites

If your organization uses IP restrictions to limit access to your GitHub resources, you must allowlist the IP addresses that Statsig services use to connect to GitHub. Follow the steps in this GitHub doc to allowlist IP addresses for your organization.

Configuring IP addresses in your Github Org

If you choose to manually add IP addresses, go to Statsig IP ranges.

First-time installation

If you're connecting GitHub to Statsig for the first time:

  1. Navigate to Settings → Integrations in the Statsig console.
  2. Locate and select the Statsig GitHub App card.
  3. Select Enable Connection.
  4. You are redirected to GitHub. Authenticate and select the target Organization and Repositories.
  5. After authorization, you are redirected back to Statsig to confirm the connection.

You can install the app on specific repositories or your entire organization. For the best results with Knowledge Graph, select all relevant repositories containing feature code.

Connecting additional projects

GitHub allows a specific GitHub App to be installed only once per GitHub Organization. If you have multiple Statsig Projects (for example, "Project 1" and "Project 2") that need access to the same GitHub Org, they share the underlying connection.

To link a new project to an existing GitHub connection:

  1. Navigate to Settings → Integrations in the Statsig console.
  2. Locate and select the Statsig GitHub App card. Statsig indicates if an existing connection exists for any other project.
  3. Select the Statsig Project you want to inherit the connection from.
  4. Confirm the link.

Migrating from legacy (PAT) integration

If you're using the older Personal Access Token (PAT) integration, upgrade to the GitHub App for improved security and functionality.

  1. Navigate to Settings → Integrations in the Statsig console.
  2. Locate and select the Statsig GitHub App card.
  3. A banner on the GitHub integration card prompts you to upgrade from the PAT-based connection.
  4. Follow the flow to install the GitHub App on your repositories.
  5. After the app is installed, the system automatically deprecates the old PAT connection.

Statsig GitHub integration FAQs

  1. Will my data be used to train LLM models?
    Statsig doesn't use your data to train LLM models, and neither do its sub-processors. Your data is secured to your organization and used to improve the services provided to you.

  2. Does Statsig store my source code?
    Statsig doesn't permanently store your source code. Statsig temporarily processes code to extract metadata and embeddings to create the Knowledge Graph, then discards it when no longer necessary.

  3. How long does it take for the code insights to appear in Statsig?
    Setting up the integration can take up to a few hours depending on the size of the repository. After the initial setup, Statsig indexes new data every 7 days.

  4. What security controls apply?
    Go to Statsig security practices for security information. Go to AI governance for AI governance information.

Was this helpful?