Flaio Docs

Appearance

GitHub Integration ​

Overview ​

The GitHub integration connects your repositories to Flaio, enabling pull request tracking, commit linking, and webhook-driven updates.

Setup ​

  1. Go to Organization Settings > Integrations > GitHub.
  2. Click Connect GitHub to start the OAuth flow.
  3. Authorize Flaio to access your GitHub organization.
  4. Select which repositories to link.

Features ​

Repository Linking ​

Link one or more GitHub repositories to your Flaio organization. Linked repositories enable:

  • Automatic session association with pull requests
  • Commit history visibility within sessions
  • Webhook-driven status updates

Webhooks ​

Flaio automatically configures a webhook on your linked repositories. This webhook notifies Flaio of:

  • Push events
  • Pull request events (opened, closed, merged, review requested)
  • Issue events

Pull Request Tracking ​

When a session is linked to a pull request, Flaio tracks its lifecycle and updates the session status accordingly.

Troubleshooting ​

  • OAuth fails — ensure you have admin access to the GitHub organization
  • Webhooks not firing — check the webhook configuration in your GitHub repository settings
  • Repository not listed — verify that Flaio has been granted access to the repository in your GitHub OAuth app settings