Skip to content

Add Playwright connection guide under browsers/#461

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

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.

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>
@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.

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