Add a Playwright CI debugger to your repo without changing how your team runs Playwright.

Install one package, wrap your config once, keep running `npx playwright test`. The next failing run generates a shareable debugging link with the evidence and next step automatically.

Start the 60-second setup View the final report

Keep your normal CI commandSecrets automatically maskedWorks with GitHub Actions

What This Feels Like

Before

Custom artifact upload scripts, raw traces, and teammates digging through CI logs by hand.

After 60 seconds

Same Playwright command. Same CI. Sentinel prints one shareable debugging link with screenshots, video, trace, logs, grouped failures, and likely cause.

Step 01

Install one package

Run `npm install -D @sentinelqa/playwright-reporter`.

Add the reporter to your existing Playwright repo. No extra service wrapper.

Step 02

Wrap your config once

Import `withSentinel(...)` and wrap your existing `playwright.config.ts`.

Keep your current test command. Sentinel hooks into the run and uploads automatically.

Step 03

Run tests normally

Push to CI or run `npx playwright test` like you already do.

On the next failure, you get a shareable report with screenshots, video, logs, traces, and grouped failures.

Pick Your Path

Two install paths. Same output.

If you already run Playwright in CI, you are basically done. Use the npm path if you want the shortest install. Use the GitHub Actions path if you want the exact workflow snippet too.

Option A: npm install

Fastest path. Install, wrap config, run tests.

Recommended

Option B: GitHub Actions

Same reporter setup, plus the workflow snippet for CI.

Open GitHub repo View GitHub Action

1. Install

bash

npm install -D @sentinelqa/playwright-reporter

2. Wrap Config

import { defineConfig } from "@playwright/test";
import { withSentinel } from "@sentinelqa/playwright-reporter";

export default withSentinel(
  defineConfig({
    reporter: [["line"]],
    outputDir: "test-results",
    use: {
      trace: "retain-on-failure",
      screenshot: "only-on-failure",
      video: "retain-on-failure"
    }
  }),
  {
    project: "my-app"
  }
);

3. Run CI

yaml

name: playwright

on:
  push:
    branches: [main]
  pull_request:

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm ci
      - run: npx playwright install --with-deps
      - run: npx playwright test

What You Get

The next failed run turns into a debugging link your team can actually use.

One run link with screenshots, video, trace, logs, grouped failures, and likely cause

Evidence-first debugging instead of hunting through artifacts manually

Public share flow for fast collaboration and a private workspace path when needed

Sanity Check

If this looks useful, you already understand the product.

Sentinel is a Playwright CI debugger, not another passive test report. It rides on the artifacts you already produce and keeps adoption light enough for a teammate to try in one CI run.

View demo Full docs