Skip to content

Add Playwright connection guide under browsers/ - #461

Closed
robertjamesprior wants to merge 1 commit into
mainfrom
hypeship/docs-playwright-page
Closed

Add Playwright connection guide under browsers/#461
robertjamesprior wants to merge 1 commit into
mainfrom
hypeship/docs-playwright-page

Conversation

@robertjamesprior

@robertjamesprior robertjamesprior commented Jul 24, 2026

Copy link
Copy Markdown

Playwright had no page of its own — it was covered only as one tab in Control and via the separate Playwright Execution page.

Why this matters for agents, not just search

Kernel's docs publish an auto-generated llms.txt — a full index of every doc page with a one-line description, meant for AI coding agents to fetch before acting. Today browser-use, stagehand, magnitude, and notte are all entries in it; Playwright is not. A developer who tells Claude Code / Cursor "add cloud browser support to my Playwright script" has nothing to fetch — the agent reads the index, finds no Playwright entry, and can't route to a guide.

This PR adds the page, so the index gains:

[Playwright](https://kernel.sh/docs/browsers/playwright.md): Connect Playwright to a Kernel cloud browser over CDP

Note: the four framework entries above ship with no description — just link text. This page's description frontmatter is keyword-focused (Playwright, cloud browser, CDP), so the entry is actually more matchable than its neighbors. The docs.json nav entry is what populates the llms.txt line — without it there is no line.

Architecture

Keeps Playwright out of integrations/ (it is a CDP client, not a framework layered on top) and gives it a first-class page under browsers/, alongside playwright-execution and viewport.

Changes

  • New browsers/playwright.mdx — framework-guide depth: install, create-a-browser + connectOverCDP URL swap (TS + Python), viewport config, stealth, a "why run Playwright on Kernel" section, next steps.
  • introduction/control.mdx — stays the conceptual overview; the CDP tab and "Going deeper" link out to the new page.
  • Reciprocal <Note>s between playwright and playwright-execution so each disambiguates the other (connect-your-own-client vs run-in-the-VM), fixing the naming collision from both directions.
  • docs.json — nav entry in the Intermediate group, before playwright-execution.

Method/param names (connectOverCDP, cdp_ws_url, delete_by_id/deleteByID, stealth, viewport) match existing docs usage. Not previewed locally — Mintlify has no build step; docs.json validated as JSON.

@vercel

vercel Bot commented Jul 24, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Error Error Jul 24, 2026 2:51pm

@mintlify

mintlify Bot commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Kernel 🟢 Ready View Preview Jul 24, 2026, 2:52 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Playwright had no keyword-focused page of its own — it was only covered as
one tab in Control and via the separate Playwright Execution page, which are
easy to land on by mistake. Add browsers/playwright.mdx covering install, the
connectOverCDP URL swap, viewport, stealth, and why to run it on Kernel, with
Control linking out to it and reciprocal pointers between the two Playwright
pages to disambiguate them.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@robertjamesprior
robertjamesprior force-pushed the hypeship/docs-playwright-page branch from f36ac53 to 4a59a5e Compare September 3, 2026 02:20

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Risk assessment: Very Low

Assessed from the actual diff (4 files, +128/−1). This change is documentation-only:

  • New browsers/playwright.mdx connection guide (install, CDP connect, viewport, stealth)
  • Cross-links on introduction/control.mdx and browsers/playwright-execution.mdx
  • Single docs.json sidebar entry

No application logic, auth, CI, infrastructure, or CODEOWNERS surface. Examples reuse APIs already documented elsewhere (connectOverCDP / cdp_ws_url, viewport, stealth). No prior approval on this PR.

Decision: Approve.

Open in Web View Automation 

Sent by Cursor Automation: Assign PR reviewers

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant