# Remote Playwright

> Deploy and connect to a remote Playwright browser on an OpenShift cluster. Sets up a Playwright run-server pod, port-forwarding, and @playwright/cli for interactive browser automation (goto, click, snapshot, screenshot, video recording). Use when you need a remote browser for E2E interaction or visual verification on a cluster.

- Skill: `quay/remote-playwright` (Agent Skill)
- Install (CLI): `npx skillmds@latest add quay/remote-playwright`
- Raw SKILL.md: https://api.skillmd.com/api/skills/quay/remote-playwright/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: quay (https://skillmd.com/u/quay)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/quay/remote-playwright

---


# Remote Playwright Browser

Deploy and connect to a Playwright browser running on an OpenShift cluster.

## Arguments

Parse `$ARGUMENTS` into at most two values before invoking Bash:
- **Arg 1**: KUBECONFIG path (default: `/tmp/k`)
- **Arg 2**: Namespace (default: `playwright`)

## Step 1: Deploy and Connect

```bash
bash .claude/scripts/remote-playwright.sh up "$KUBECONFIG_PATH" "$NAMESPACE"
```

The script handles everything: version resolution, deployment, port-forwarding, and CLI connection. Wait for the `=== Ready ===` output.

## Step 2: Verify

```bash
npx @playwright/cli goto https://example.com
npx @playwright/cli snapshot
npx @playwright/cli screenshot
```

## Available Commands

- `npx @playwright/cli goto <url>` — navigate
- `npx @playwright/cli snapshot` — accessibility tree
- `npx @playwright/cli screenshot` — save PNG
- `npx @playwright/cli click <ref>` — click element by ref from snapshot
- `npx @playwright/cli fill <ref> <text>` — fill input
- `npx @playwright/cli video-start` / `video-stop` — record session
- `npx @playwright/cli tab-list` / `tab-new` / `tab-select` — manage tabs

## Teardown

```bash
bash .claude/scripts/remote-playwright.sh down "$KUBECONFIG_PATH" "$NAMESPACE"
```