Connect Pie Bot

Pie Bot is the GitHub integration that powers Pie Loop. It reads your PR diffs, generates targeted tests, runs them against your preview environment, and posts results directly on the PR. Connecting Pie Bot is what activates Pie Loop for your repository.

ℹ️
Mobile apps: Pie Loop support for mobile builds is coming soon. If you’re testing a mobile app, reach out to support@pie.inc and the team will get you set up.

What you’ll need:

  • A Pie account with an active workspace
  • A GitHub account with access to the repositories you want to connect
  • GitHub organization admin rights, or the ability to request them (see Step 5)

Step 1: Open Settings from the Dashboard

From the Pie dashboard, click Settings in the bottom of the left sidebar navigation.

Pie dashboard with Settings highlighted in the left sidebar Go to Settings from the sidebar, at the bottom of the left navigation


Step 2: Navigate to Integrations and find Pie Bot

In Settings, click Integrations in the left menu. You’ll see a list of available integrations. Find Pie Bot and click Connect to begin the GitHub authorization flow.

Settings Integrations page showing Pie Bot with a Connect button Find Pie Bot in Settings → Integrations. Click Connect to begin.


Step 3: Sign in to GitHub

You’ll be redirected to GitHub to authorize the pie-pr-bot app. Sign in with your GitHub credentials if prompted.

GitHub OAuth sign-in page for pie-pr-bot GitHub will ask you to sign in to authorize Pie Bot access


Step 4: Select repositories

After signing in, GitHub will ask which repositories Pie Bot should have access to. You can choose:

  • All repositories — Pie Bot will run on every PR across your organization
  • Only select repositories — recommended for getting started; choose one or two repos to run first

Select your preferred scope and click Install & Authorize.


Step 5: Admin approval (if required)

ℹ️
If your GitHub organization requires admin approval for third-party app installations, Pie Bot will appear as a pending installation until an org admin approves it. Non-admin users who attempt to install will automatically trigger an approval request email to the org admin.

What Pie Bot requests access to:

PermissionLevelWhy
Code (contents)ReadTo read PR diffs and understand what changed
Pull requestsRead and WriteTo post test results and status checks on the PR
Repository metadataReadTo identify repos and branches

Pie Bot does not store your source code. It does not use your codebase to train any model. Access is scoped strictly to what is needed to generate and run tests from PR diffs.

To approve as an org admin:

  1. Go to your GitHub organization page and open Settings
  2. In the left sidebar, click GitHub Apps (under Integrations)
  3. Find pie-pr-bot in the pending or installed list and click Review request
  4. Review the requested permissions listed above
  5. Click Install to approve

Once approved, Pie Bot becomes active immediately. No further action is needed in Pie.


Step 6: You’re connected

Return to Pie. Pie Bot is now active. The next PR your team opens will trigger a test run automatically, and results will appear in Coverage Stories under Pie Loop in the sidebar.

ℹ️
Web apps: After connecting Pie Bot, you’ll also need to provide a preview URL template so Pie can open your app and verify UI changes. Reach out to support@pie.inc to get this configured.

Need Help?