Wire the self-healer into your Playwright CI.

You've already got a Playwright suite running in GitHub Actions. Here's how to add the self-healer so it opens a fix PR when a selector breaks. It heals existing selectors — it doesn't write new tests for you.

Steps 1 and 2 can be done in any order.

1. 01

   Install the GitHub App

   Pick the repo(s) where your Playwright suite runs.

   Add to GitHub
2. 02

   Request your API key

   Tell us where to send it. We issue keys manually for now — no instant access.

   Name

   Work email

   Repo URL

   Request your key
3. 03

   Add the reporter

   🔒 Complete steps 1–2 first to get your key.

   Install the package

   npm install @scaleqa/playwright-healer

   Register the reporter in playwright.config.ts

   export default defineConfig({
     reporter: [
       ['list'],
       ['@scaleqa/playwright-healer/reporter'], // add this line
     ],
   });

   Add two env vars in your CI

   SELFHEALER_ENDPOINT=https://api.scaleqa.dev/heal/batch
   SELFHEALER_API_KEY=<the-key-from-step-2>

4. 04

   Done

   Push a failing test. We open the fix PR.