> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mobileboost.io/llms.txt
> Use this file to discover all available pages before exploring further.

# CI integration

> View test results as PR status checks via the MobileBoost GitHub App

The MobileBoost Test Agent GitHub App reports test results directly on your pull requests, so your team gets feedback without leaving GitHub.

## MobileBoost Test Agent GitHub App

Install the **MobileBoost Test Agent** GitHub App on your repository. Once installed, it automatically:

* Picks up test executions triggered from pull requests
* Updates the PR with a **status check** (pending, pass, fail)
* Posts a **summary comment** with results, screenshots, and links to detailed reports

## How it works

<Steps>
  <Step title="Tests are triggered from a PR">
    Your GitHub Actions workflow uploads a build and triggers tests via the MobileBoost API (see [CI integration under Test execution](/test-agent/ci-integration)).
  </Step>

  <Step title="Status check shows pending">
    The MobileBoost Test Agent sets a pending status check on the PR while tests are running.
  </Step>

  <Step title="Results are reported">
    Once tests complete, the status check updates to pass or fail, and a summary comment is posted on the PR with:

    * Pass/fail status per test
    * Step-by-step screenshots
    * Links to full video recordings and logs
  </Step>
</Steps>

## Branch protection

You can require the MobileBoost status check to pass before merging by adding it to your branch protection rules in **GitHub > Settings > Branches > Branch protection rules**.

This ensures no PR is merged without passing mobile tests.