Connect to GitHub

Get started with Trunk CI Autopilot to get root cause analysis with fixes for CI/test failures.

CI Autopilot automatically investigates CI failures in your pull requests and provides root cause analysis with suggested fixes, saving your team hours of debugging time. The following steps guide you through the onboarding process.

Prerequisites

  • GitHub repository with GitHub Action workflows

  • Admin access to your GitHub organization

  • 5 minutes for setup

Step 1 of 3: Open Trunk CI Autopilot

Open the Trunk app and navigate to the CI Autopilot, which can be found in the top navigation. The following welcome screen will be shown.

CI Autopilot Landing Screen

✅ Success: You see the CI Autopilot welcome screen with an 'Install GitHub App' button

Step 2 of 3: Install GitHub App

Click on "Install GitHub App" to get started. A GitHub page to select which organization to enable the app for and what repositories Trunk should have access to will be shown.

Trunk's GitHub app requires the following permissions:

  • Read access to administration, commit statuses, and metadata

  • Read and write access to actions, checks, code, issues, pull requests, and workflows

Select your repositories and click Install to return to Trunk's confirmation screen.

✅ Success: You return to Trunk and see a list of your accessible repositories

Step 3 of 3: Enable CI Autopilot

GitHub App installation confirmation

Select the repository you want to enable the CI Autopilot for from the dropdown list and click on "Enable".

A confirmation view will be shown and Trunk will open the activity feed. The CI Autopilot is now running in the background and waiting for the next PR failure to conduct the first failure investigation.

Empty activity feed after CI Autopilot was enabled

✅ Success: The activity feed shows 'CI Autopilot is monitoring this repository' with an empty investigation list.

What's Next?

CI Autopilot will start investigations whenever a CI workflow fails. Create a failing PR to initiate the first investigation.

In the meantime, learn about how to use the CI Autopilot:

Last updated