Connect Playwright or Puppeteer to a Gravix browser over a tokened CDP bridge
Drive a Gravix browser from your own tooling — Playwright, Puppeteer, or anything that speaks the Chrome DevTools Protocol. cdp_endpoint opens a tokened bridge into the running browser: connect with the returned URL and your driver sees a normal Chromium.CLI and cURL examples use $RT and browser b1 (Sessions).
Connect Playwright
The response carries port, path, and token (minted when you don’t supply
one). The bridge is reachable through the runtime’s service-port host —
wss://{port}-{runtime_id}.service.gravixlayer.ai{path}?token={token} — the same
convention as live view. Each
bridge accepts multiple concurrent driver connections; cdp_endpoint_stop tears
it down.
from gravixlayer import GravixLayerfrom playwright.sync_api import sync_playwrightclient = GravixLayer() # reads GRAVIXLAYER_API_KEYsandbox = client.runtime.create(template="browser-small")bid = sandbox.browser.open(url="https://example.com")["browser_id"]ep = sandbox.browser.cdp_endpoint(bid)# Service-port convention: wss://{port}-{runtime_id}.service.gravixlayer.aiws = f"wss://{ep['port']}-{sandbox.runtime_id}.service.gravixlayer.ai{ep['path']}?token={ep['token']}"with sync_playwright() as p: browser = p.chromium.connect(ws) page = browser.contexts[0].pages[0] print(page.title()) browser.close() # closes the driver session, not the Gravix browsersandbox.browser.cdp_endpoint_stop(bid)sandbox.kill()
import { GravixLayer } from 'gravixlayer';import { chromium } from 'playwright';const client = new GravixLayer();const sandbox = await client.runtime.create({ template: 'browser-small' });const bid = (await sandbox.browser.open({ url: 'https://example.com' })).browserId;const ep = await sandbox.browser.cdpEndpoint(bid);// Service-port convention: wss://{port}-{runtime_id}.service.gravixlayer.aiconst ws = `wss://${ep.port}-${sandbox.runtimeId}.service.gravixlayer.ai${ep.path}?token=${ep.token}`;const browser = await chromium.connect(ws);const page = browser.contexts()[0]?.pages()[0];console.log(await page?.title());await browser.close(); // closes the driver session, not the Gravix browserawait sandbox.browser.cdpEndpointStop(bid);await sandbox.kill();
Closing the driver’s connection leaves the Gravix browser running — that is what makes mixed control (SDK + your driver on the same session) work. Driver-level Browser.close calls are rejected so a stray client cannot kill the shared session. Use cdp_endpoint_stop to retire the bridge, and browser.close to close the browser itself.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Gravix Layer","description":"Gravix Layer documentation. Run code, commands, files, a browser, and a desktop in isolated sandboxes. Python and TypeScript SDKs, CLI, and REST API.","colors":{"primary":"#0D9373"},"logo":{"light":"https://mintcdn.com/gravixlayer-8e1b904a/qo4IEPExSB9egsCe/images/logo/mark-ink.svg?fit=max\u0026auto=format\u0026n=qo4IEPExSB9egsCe\u0026q=85\u0026s=31d1beacebbe909dcc56ef745007d2fd","dark":"https://mintcdn.com/gravixlayer-8e1b904a/qo4IEPExSB9egsCe/images/logo/mark-paper.svg?fit=max\u0026auto=format\u0026n=qo4IEPExSB9egsCe\u0026q=85\u0026s=49f04180ba2eeb351ed4819b61a2b6be","href":"https://gravixlayer.ai"},"favicon":"https://mintcdn.com/gravixlayer-8e1b904a/qo4IEPExSB9egsCe/images/favicon.svg?fit=max\u0026auto=format\u0026n=qo4IEPExSB9egsCe\u0026q=85\u0026s=017fe30270f0110938d1dc6bfabbd446","api":{"examples":{"languages":["python","typescript","curl"]}},"appearance":{"default":"system"},"navbar":{"primary":{"type":"button","label":"Start building","href":"https://gravixlayer.ai/early-access"}},"footer":{"socials":{"github":"https://github.com/gravixlayer","x":"https://x.com/gravixlayer"}},"seo":{"organization":{"name":"Gravix Layer","url":"https://gravixlayer.ai","logo":"https://gravixlayer.ai/gravix-hourglass-logo.svg","sameAs":["https://github.com/gravixlayer","https://x.com/gravixlayer"]}},"icons":{"library":"lucide"},"banner":{"content":"Gravix Layer is in **private preview**. APIs and behavior may change without notice.","dismissible":true,"type":"info"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"gravixlayer-8e1b904a","hasAudioNarration":false,"actualSubdomain":"gravixlayer-8e1b904a","customDomains":["docs.gravixlayer.ai"],"gitSource":{"type":"github","owner":"gravixlayer","repo":"docsv2","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6aeb838f4380bc014e1951af","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"Documentation","count":98},{"language":"default","tag":"Runtime","count":87},{"language":"default","tag":"Browser Use","count":15},{"language":"default","tag":"File","count":15},{"language":"default","tag":"Guides","count":14},{"language":"default","tag":"Git","count":12},{"language":"default","tag":"Getting Started","count":10},{"language":"default","tag":"Lifecycle","count":9},{"language":"default","tag":"Computer Use","count":8},{"language":"default","tag":"Snapshot","count":8}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"diagrams.css","content":":root{--gx-bg: #ffffff;--gx-fg: #18181b;--gx-card: #ffffff;--gx-surface-alt: #f4f4f5;--gx-muted: #71717a;--gx-border: #e4e4e7;--gx-border-subtle: #f4f4f5;--gx-signal: #0D9373;--gx-signal-text: #0D9373;--gx-destructive: #dc2626;--gx-font-sans: ui-sans-serif, system-ui, sans-serif;--gx-font-mono: ui-monospace, SFMono-Regular, Menlo, monospace;--gx-track: 0;--gx-body: 0.9375rem;--gx-small: 0.875rem;--gx-code: 0.8125rem;--gx-radius: 8px}html.dark{--gx-bg: #09090b;--gx-fg: #fafafa;--gx-card: #18181b;--gx-surface-alt: #09090b;--gx-muted: #a1a1aa;--gx-border: rgb(255 255 255 / 0.12);--gx-border-subtle: rgb(255 255 255 / 0.08);--gx-signal: #2dd4a8;--gx-signal-text: #5eead4;--gx-destructive: #f87171}.gx-frame{position:relative;margin:1.75rem 0 2rem;padding:1.15rem 1.15rem 1rem;background:var(--gx-surface-alt);border:1px solid var(--gx-border-subtle);border-radius:var(--gx-radius);color:var(--gx-fg);font-family:var(--gx-font-sans);font-size:var(--gx-small);line-height:1.45;letter-spacing:var(--gx-track);container-type:inline-size}.gx-frame *,.gx-frame *::before,.gx-frame *::after{box-sizing:border-box}#content .gx-frame p,.gx-frame p,.gx-caption{margin:0 0 1rem!important;max-width:42rem;color:var(--gx-muted)!important;font-size:var(--gx-body)!important;line-height:1.5!important;letter-spacing:var(--gx-track)}.gx-flow{display:flex;align-items:stretch}.gx-flow:has(>.gx-col){align-items:center}.gx-flow>.gx-node,.gx-flow>.gx-col{flex:1 1 0;min-width:0}.gx-col{display:flex;flex-direction:column;min-width:0}.gx-node,.gx-step{position:relative;display:flex;flex-direction:column;align-items:flex-start;gap:0.2rem;min-width:0;padding:0.95rem 1rem 1rem;background:var(--gx-card);border:1px solid var(--gx-border);border-radius:var(--gx-radius);box-shadow:0 1px 2px rgb(14 22 18 / 0.04)}.gx-node-result{border-color:rgb(0 173 105 / 0.45)}.gx-sandbox{position:relative;align-items:stretch}.gx-sandbox-copy{display:flex;flex-direction:column;align-items:flex-start;gap:0.2rem;padding-right:6.75rem}.gx-sandbox .gx-chips{display:grid;grid-template-columns:repeat(4, max-content);justify-content:start;gap:0.5rem;width:100%}.gx-sandbox .gx-chip{background:transparent;border:none;font-size:0.8125rem;padding:0.35rem 0.55rem}.gx-sandbox .gx-chip svg{width:20px;height:20px}.gx-resources{position:absolute;top:0.7rem;right:0.7rem;display:flex;gap:0.55rem}.gx-resource{display:flex;flex-direction:column;align-items:center;gap:0.12rem;color:var(--gx-muted);font-size:0.625rem;font-weight:600;letter-spacing:0.04em;text-transform:uppercase}.gx-resource svg{width:22px;height:22px;flex:0 0 auto}.gx-chip svg{width:18px;height:18px;flex:0 0 auto}.gx-chip{gap:0.28rem}.gx-node-dashed{background:transparent;border-style:dashed;box-shadow:none}.gx-index{display:inline-flex;align-items:center;justify-content:center;width:1.35rem;height:1.35rem;margin-bottom:0.45rem;border-radius:999px;background:var(--gx-fg);color:var(--gx-bg);font-size:0.75rem;font-weight:600;letter-spacing:0;line-height:1}.gx-node-result>.gx-index,.gx-step-active>.gx-index{background:var(--gx-signal);color:#0e1612}.gx-node-kicker{font-size:0.6875rem;font-weight:600;letter-spacing:0.08em;text-transform:uppercase;color:var(--gx-signal-text)}.gx-node-title,.gx-step-title{font-weight:600;font-size:var(--gx-body);letter-spacing:-0.008em;color:var(--gx-fg)}.gx-node-title-mono{font-family:var(--gx-font-mono);font-size:0.8125rem;font-weight:500;letter-spacing:0;color:var(--gx-fg);overflow-wrap:anywhere}.gx-node-sub,.gx-step-sub{color:var(--gx-muted);font-size:0.8125rem;line-height:1.45;overflow-wrap:anywhere}.gx-chips{display:flex;flex-wrap:wrap;gap:0.375rem;margin-top:0.55rem}.gx-chip{display:inline-flex;align-items:center;padding:0.22rem 0.5rem;border-radius:6px;background:var(--gx-surface-alt);border:1px solid var(--gx-border-subtle);font-family:var(--gx-font-mono);font-size:0.6875rem;letter-spacing:0.02em;color:var(--gx-fg);white-space:nowrap}.gx-chip-signal{background:rgb(0 173 105 / 0.12);border-color:rgb(0 173 105 / 0.35);color:var(--gx-signal-text)}.gx-arrow{position:relative;display:flex;align-items:center;justify-content:center;flex:0 0 5.25rem;min-width:5.25rem}.gx-arrow::before{content:\"\";position:absolute;left:0.15rem;right:0.45rem;top:50%;height:1.5px;background:var(--gx-muted);opacity:0.55}.gx-arrow::after{content:\"\";position:absolute;right:0.35rem;top:50%;width:7px;height:7px;border-top:1.5px solid var(--gx-muted);border-right:1.5px solid var(--gx-muted);transform:translateY(-50%) rotate(45deg);opacity:0.8}.gx-arrow-signal::before{background:var(--gx-signal);opacity:1}.gx-arrow-signal::after{border-color:var(--gx-signal);opacity:1}.gx-arrow-label{position:relative;z-index:1;padding:0.05rem 0.35rem;background:var(--gx-surface-alt);border-radius:999px;font-size:0.6875rem;font-weight:600;letter-spacing:0;color:var(--gx-muted);white-space:nowrap}.gx-arrow-signal .gx-arrow-label{color:var(--gx-signal-text)}.gx-runtime-map{align-items:stretch}.gx-runtime-shell{flex:1.45 1 0;min-width:0;display:flex;flex-direction:column;gap:0.85rem;padding:0.85rem;border:1.5px solid rgb(13 147 115 / 0.55);border-radius:var(--gx-radius);background:rgb(13 147 115 / 0.1)}.gx-attach-block{display:flex;flex-direction:column;gap:0.55rem}.gx-attach-block>.gx-attach-label{position:static;transform:none;align-self:flex-start;padding:0.15rem 0;background:transparent;color:var(--gx-fg);letter-spacing:0.06em}.gx-attach-cards{display:grid;grid-template-columns:repeat(2, minmax(0, 1fr));gap:0.75rem}.gx-attach-card{background:var(--gx-card);border:1.5px solid var(--gx-signal);box-shadow:0 1px 2px rgb(14 22 18 / 0.08)}.gx-attach{display:grid;grid-template-columns:repeat(2, minmax(0, 1fr));gap:0.75rem;margin-top:0.85rem;padding-top:1.15rem;position:relative}.gx-attach::before{content:\"\";position:absolute;left:18%;right:18%;top:0.15rem;border-top:1px dashed var(--gx-border)}.gx-attach-label{position:absolute;top:0.15rem;left:50%;transform:translate(-50%, -50%);padding:0 0.4rem;background:var(--gx-surface-alt);font-size:0.6875rem;font-weight:600;letter-spacing:0.08em;text-transform:uppercase;color:var(--gx-muted);white-space:nowrap}.gx-attach>.gx-node::before{content:\"\";position:absolute;top:-1.15rem;left:50%;height:1.15rem;border-left:1px dashed var(--gx-border)}.gx-rules{display:grid;grid-template-columns:minmax(0, 1fr) auto auto;width:100%;margin-top:0.65rem;font-family:var(--gx-font-mono);font-size:var(--gx-code)}.gx-rules>span{padding:0.4rem 0;border-bottom:1px solid var(--gx-border-subtle);color:var(--gx-fg);white-space:nowrap;overflow:hidden;text-overflow:ellipsis}.gx-rules>span:nth-child(3n+2){padding-inline:0.85rem;color:var(--gx-muted)}.gx-rules>span:nth-child(3n){text-align:right}.gx-rules-h{font-family:var(--gx-font-sans);font-size:0.6875rem;font-weight:600;letter-spacing:0.08em;text-transform:uppercase;color:var(--gx-muted)!important}.gx-rules .gx-ok{color:var(--gx-signal-text);font-weight:600}.gx-rules .gx-deny{color:var(--gx-destructive);font-weight:600}.gx-steps{display:grid;grid-template-columns:repeat(4, minmax(0, 1fr));gap:0.75rem;margin-bottom:0.85rem}.gx-step-num{display:none}.gx-log{margin:0;padding:0.8rem 0.95rem;background:var(--gx-card);border:1px solid var(--gx-border);border-radius:var(--gx-radius);font-family:var(--gx-font-mono);font-size:var(--gx-code);line-height:1.65;color:var(--gx-fg);overflow-x:auto}.gx-log-line{display:flex;gap:0.75rem;white-space:nowrap}.gx-log-prompt{flex:0 0 4ch;color:var(--gx-muted)}.gx-log-ok{color:var(--gx-signal-text)}.gx-log-muted,.gx-log-out{color:var(--gx-muted)}.gx-log-out{margin-left:auto;padding-left:1.5rem}#content .gx-frame strong,.gx-frame-facts strong{color:var(--gx-fg)!important;font-weight:600!important}.gx-frame-facts{display:flex;flex-wrap:wrap;gap:0.4rem 1.25rem;margin-top:0.95rem;padding-top:0.8rem;border-top:1px solid var(--gx-border-subtle);color:var(--gx-muted);font-size:0.8125rem;letter-spacing:0}.gx-arch{display:block;width:100%;height:auto;margin:0.5rem 0 1.75rem}html:not(.dark) .gx-arch .gx-cloud-dark{visibility:hidden}html.dark .gx-arch .gx-cloud-light{visibility:hidden}@container (max-width: 720px){.gx-flow{flex-direction:column;gap:0}.gx-arrow{flex-basis:auto;width:auto;min-width:0;height:2.75rem;justify-content:flex-start;padding-left:1.1rem}.gx-arrow::before{left:1.55rem;right:auto;top:0.35rem;bottom:0.7rem;width:1.5px;height:auto}.gx-arrow::after{right:auto;left:1.55rem;top:auto;bottom:0.45rem;transform:translateX(-50%) rotate(135deg)}.gx-arrow-label{margin-left:0.85rem}.gx-steps{grid-template-columns:repeat(2, minmax(0, 1fr))}.gx-attach,.gx-attach-cards{grid-template-columns:1fr;padding-top:0.35rem}.gx-attach::before,.gx-attach>.gx-node::before{display:none}.gx-attach-label{position:static;transform:none;margin:0.15rem 0 0.15rem;padding:0;background:transparent}}"},{"filePath":"tables.css","content":"td code,th code{white-space:nowrap;overflow-wrap:normal;word-break:normal}.endpoint-table{overflow-x:auto}.endpoint-table th:first-child,.endpoint-table td:first-child{width:1%;white-space:nowrap}"}]}
{"page":{"pagePath":"documentation/agentruntime/browser-use/cdp","slug":"/documentation/agentruntime/browser-use/cdp","pageMetadata":{"title":"Bring your own driver","sidebarTitle":"CDP endpoint","icon":"plug","description":"Connect Playwright or Puppeteer to a Gravix browser over a tokened CDP bridge","href":"/documentation/agentruntime/browser-use/cdp"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Connect Playwright or Puppeteer to a Gravix browser over a tokened CDP bridge\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,CodeGroup,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!CodeGroup)_missingMdxReference(`CodeGroup`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Drive a Gravix browser from your own tooling — Playwright, Puppeteer, or anything that speaks the Chrome DevTools Protocol. `,_jsx(_components.code,{children:`cdp_endpoint`}),` opens a tokened bridge into the running browser: connect with the returned URL and your driver sees a normal Chromium.`]}),`\n`,_jsxs(_components.p,{children:[`CLI and cURL examples use `,_jsx(_components.code,{children:`$RT`}),` and browser `,_jsx(_components.code,{children:`b1`}),` (`,_jsx(_components.a,{href:`/documentation/agentruntime/browser-use/browser`,children:`Sessions`}),`).`]}),`\n`,_jsx(Heading,{level:`2`,id:`connect-playwright`,children:`Connect Playwright`}),`\n`,_jsxs(_components.p,{children:[`The response carries `,_jsx(_components.code,{children:`port`}),`, `,_jsx(_components.code,{children:`path`}),`, and `,_jsx(_components.code,{children:`token`}),` (minted when you don’t supply\none). The bridge is reachable through the runtime’s service-port host —\n`,_jsx(_components.code,{children:`wss://{port}-{runtime_id}.service.gravixlayer.ai{path}?token={token}`}),` — the same\nconvention as `,_jsx(_components.a,{href:`/documentation/agentruntime/browser-use/capture`,children:`live view`}),`. Each\nbridge accepts multiple concurrent driver connections; `,_jsx(_components.code,{children:`cdp_endpoint_stop`}),` tears\nit down.`]}),`\n`,_jsxs(CodeGroup,{children:[_jsx(CodeBlock,{filename:`Python`,numberOfLines:`19`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`19`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` gravixlayer `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` GravixLayer`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` playwright.sync_api `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` sync_playwright`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`client `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` GravixLayer() `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# reads GRAVIXLAYER_API_KEY`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`sandbox `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` client.runtime.create(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`template`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"browser-small\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`bid `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` sandbox.browser.open(`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`url`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`)[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"browser_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`ep `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` sandbox.browser.cdp_endpoint(bid)`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Service-port convention: wss://{port}-{runtime_id}.service.gravixlayer.ai`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`ws `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` f`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"wss://`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`ep[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'port'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`-`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`sandbox.runtime_id`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`.service.gravixlayer.ai`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`ep[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'path'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`?token=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`{`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`ep[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'token'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`with`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` sync_playwright() `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`as`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` p:`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` browser `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` p.chromium.connect(ws)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` page `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` browser.contexts[`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`].pages[`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:` print`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(page.title())`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` browser.close() `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# closes the driver session, not the Gravix browser`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`sandbox.browser.cdp_endpoint_stop(bid)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`sandbox.kill()`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`TypeScript`,numberOfLines:`18`,language:`typescript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`typescript`,children:_jsxs(_components.code,{language:`typescript`,numberOfLines:`18`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`GravixLayer`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'gravixlayer'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` { `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`chromium`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` } `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`from`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'playwright'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` client`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:` new`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:` GravixLayer`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` sandbox`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` client`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`runtime`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`create`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`template:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'browser-small'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` });`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` bid`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` (`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` sandbox`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`browser`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`open`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`({ `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`url:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://example.com'`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` })).`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`browserId`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` ep`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` sandbox`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`browser`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`cdpEndpoint`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`bid`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// Service-port convention: wss://{port}-{runtime_id}.service.gravixlayer.ai`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` ws`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\" `wss://\"}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ep`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`port`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`-`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`sandbox`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`runtimeId`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`.service.gravixlayer.ai`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ep`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`path`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`?token=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:\"${\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ep`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`token`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#569CD6`},children:`}`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:\"`\"}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`;`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` browser`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` chromium`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`connect`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`ws`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`const`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#4FC1FF`},children:` page`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` =`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` browser`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`contexts`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`()[`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`]?.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`pages`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`()[`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`];`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`console`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`log`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` page`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`?.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`title`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`());`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` browser`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`close`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(); `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`// closes the driver session, not the Gravix browser`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` sandbox`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`browser`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`cdpEndpointStop`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`(`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`bid`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`);`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#C586C0`},children:`await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` sandbox`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`.`}),_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`kill`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`();`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`CLI`,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`gravixlayer`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` runtime`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` browser`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` cdp-endpoint`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$RT`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --browser`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` b1`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --output`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` json`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# → {\"port\": 9223, \"path\": \"/cdp\", \"token\": \"…\"}`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Connect: wss://9223-$RT.service.gravixlayer.ai/cdp?token=…`})}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`gravixlayer`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` runtime`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` browser`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` cdp-endpoint-stop`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$RT`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --browser`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` b1`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`9`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`API`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"https://api.gravixlayer.ai/v1\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -sS`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$API`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/agents/runtime/`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$RT`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/browser/b1/cdp_endpoint\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$GRAVIXLAYER_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{}'`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -sS`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$API`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/agents/runtime/`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$RT`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`/browser/b1/cdp_endpoint/stop\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Authorization: Bearer `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$GRAVIXLAYER_API_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{}'`})]}),`\n`]})})})]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Closing the `,_jsx(_components.em,{children:`driver’s`}),` connection leaves the Gravix browser running — that is what makes mixed control (SDK + your driver on the same session) work. Driver-level `,_jsx(_components.code,{children:`Browser.close`}),` calls are rejected so a stray client cannot kill the shared session. Use `,_jsx(_components.code,{children:`cdp_endpoint_stop`}),` to retire the bridge, and `,_jsx(_components.code,{children:`browser.close`}),` to close the browser itself.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Bring your own driver","sidebarTitle":"CDP endpoint","icon":"plug","description":"Connect Playwright or Puppeteer to a Gravix browser over a tokened CDP bridge","href":"/documentation/agentruntime/browser-use/cdp"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Connect Playwright","slug":"connect-playwright","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"gravixlayer-8e1b904a","siteName":"Gravix Layer","title":"Bring your own driver - Gravix Layer","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-02T05:57:47.948Z","originalFileLocation":"documentation/agentruntime/browser-use/cdp.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Connect Playwright or Puppeteer to a Gravix browser over a tokened CDP bridge\">\u003cmeta data-mint-head name=\"application-name\" content=\"Gravix Layer\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gravixlayer-8e1b904a/rJbZQ6yerLvrnRv4/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/gravixlayer-8e1b904a/rJbZQ6yerLvrnRv4/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gravixlayer-8e1b904a/rJbZQ6yerLvrnRv4/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/gravixlayer-8e1b904a/rJbZQ6yerLvrnRv4/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/gravixlayer-8e1b904a/rJbZQ6yerLvrnRv4/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/gravixlayer-8e1b904a/rJbZQ6yerLvrnRv4/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/gravixlayer-8e1b904a/rJbZQ6yerLvrnRv4/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/gravixlayer-8e1b904a/rJbZQ6yerLvrnRv4/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/gravixlayer-8e1b904a/rJbZQ6yerLvrnRv4/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Bring your own driver - Gravix Layer\">\u003cmeta data-mint-head property=\"og:description\" content=\"Connect Playwright or Puppeteer to a Gravix browser over a tokened CDP bridge\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Gravix Layer\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gravixlayer.ai/documentation/agentruntime/browser-use/cdp\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://gravixlayer-8e1b904a.mintlify.site/_mintlify/api/og/v2?division=Browser+Use\u0026amp;title=Bring+your+own+driver\u0026amp;description=Connect+Playwright+or+Puppeteer+to+a+Gravix+browser+over+a+tokened+CDP+bridge\u0026amp;theme=e638b4b1b29a979214b97349\u0026amp;signature=344da699f3e9f559a8647c17c2edd5ef59fb41b65332ad6d2af858534c094d0e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Bring your own driver - Gravix Layer\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Connect Playwright or Puppeteer to a Gravix browser over a tokened CDP bridge\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://gravixlayer-8e1b904a.mintlify.site/_mintlify/api/og/v2?division=Browser+Use\u0026amp;title=Bring+your+own+driver\u0026amp;description=Connect+Playwright+or+Puppeteer+to+a+Gravix+browser+over+a+tokened+CDP+bridge\u0026amp;theme=e638b4b1b29a979214b97349\u0026amp;signature=344da699f3e9f559a8647c17c2edd5ef59fb41b65332ad6d2af858534c094d0e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/gravixlayer-8e1b904a/rJbZQ6yerLvrnRv4/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Gravix Layer\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.gravixlayer.ai/documentation/agentruntime/browser-use/cdp\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/documentation/agentruntime/browser-use/cdp.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://gravixlayer.ai/#organization\",\"name\":\"Gravix Layer\",\"url\":\"https://gravixlayer.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://gravixlayer.ai/gravix-hourglass-logo.svg\"},\"sameAs\":[\"https://github.com/gravixlayer\",\"https://x.com/gravixlayer\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.gravixlayer.ai#website\",\"name\":\"Gravix Layer\",\"url\":\"https://docs.gravixlayer.ai\",\"publisher\":{\"@id\":\"https://gravixlayer.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.gravixlayer.ai/documentation/agentruntime/browser-use/cdp#webpage\",\"url\":\"https://docs.gravixlayer.ai/documentation/agentruntime/browser-use/cdp\",\"name\":\"Bring your own driver\",\"description\":\"Connect Playwright or Puppeteer to a Gravix browser over a tokened CDP bridge\",\"dateModified\":\"2026-11-02T05:57:47.948Z\",\"isPartOf\":{\"@id\":\"https://docs.gravixlayer.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gravixlayer.ai/documentation/agentruntime/browser-use/cdp#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gravixlayer.ai/documentation/agentruntime/browser-use/cdp#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Runtime\",\"item\":\"https://docs.gravixlayer.ai/documentation/agentruntime/runtime-overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Browser Use\",\"item\":\"https://docs.gravixlayer.ai/documentation/agentruntime/browser-use/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Bring your own driver\",\"item\":\"https://docs.gravixlayer.ai/documentation/agentruntime/browser-use/cdp\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.gravixlayer.ai/documentation/agentruntime/browser-use/cdp#article\",\"headline\":\"Bring your own driver\",\"name\":\"Bring your own driver\",\"description\":\"Connect Playwright or Puppeteer to a Gravix browser over a tokened CDP bridge\",\"url\":\"https://docs.gravixlayer.ai/documentation/agentruntime/browser-use/cdp\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gravixlayer.ai/documentation/agentruntime/browser-use/cdp#webpage\"},\"dateModified\":\"2026-11-02T05:57:47.948Z\",\"publisher\":{\"@id\":\"https://gravixlayer.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.gravixlayer.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Gravix Layer\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Gravix Layer\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/documentation/agentruntime/browser-use/cdp.md","siteName":"Gravix Layer","nav":{"global":null,"tabs":[{"tab":"Documentation","icon":"book-open","groups":[{"group":"Getting Started","icon":"rocket","pages":[{"title":"Overview","sidebarTitle":"Overview","icon":"house","href":"/documentation/agentruntime/overview"},{"title":"Quickstart","sidebarTitle":"Quickstart","icon":"fast-forward","href":"/documentation/agentruntime/getting-started/quickstart"},{"title":"Architecture","sidebarTitle":"Architecture","icon":"route","href":"/documentation/agentruntime/architecture"},{"title":"Use the SDK","sidebarTitle":"SDK","icon":"code-xml","href":"/documentation/agentruntime/sdk-usage"},{"title":"Use the CLI","sidebarTitle":"CLI","icon":"square-chevron-right","href":"/documentation/agentruntime/cli-usage"},{"title":"Store a credential","sidebarTitle":"Identity","icon":"fingerprint","href":"/documentation/agentruntime/getting-started/identity-providers"},{"title":"Limit outbound traffic","sidebarTitle":"Network","icon":"shield","href":"/documentation/agentruntime/getting-started/network-policies"},{"title":"Expose a web service","sidebarTitle":"Web Services","icon":"network","href":"/documentation/agentruntime/getting-started/web-services"},{"title":"Quotas","sidebarTitle":"Quotas","icon":"gauge","href":"/documentation/agentruntime/service-quotas"},{"title":"Pricing","sidebarTitle":"Pricing","icon":"tag","href":"/documentation/agentruntime/pricing"}]},{"group":"Runtime","icon":"box","pages":[{"title":"How a runtime works","sidebarTitle":"Overview","icon":"server","href":"/documentation/agentruntime/runtime-overview"},{"group":"Lifecycle","icon":"refresh-cw","pages":[{"title":"Create a runtime","sidebarTitle":"Create","icon":"plus","href":"/documentation/agentruntime/sandbox-management/create-sandbox"},{"title":"List runtimes","sidebarTitle":"List","icon":"list","href":"/documentation/agentruntime/sandbox-management/list-sandboxes"},{"title":"Check a runtime","sidebarTitle":"Info","icon":"info","href":"/documentation/agentruntime/sandbox-management/get-sandbox-info"},{"title":"Pause a runtime","sidebarTitle":"Pause","icon":"pause","href":"/documentation/agentruntime/sandbox-management/pause-resume"},{"title":"Terminate a runtime","sidebarTitle":"Terminate","icon":"power","href":"/documentation/agentruntime/sandbox-management/terminate-sandbox"},{"title":"Extend the timeout","sidebarTitle":"Timeout","icon":"timer","href":"/documentation/agentruntime/sandbox-management/update-timeout"},{"title":"Read resource use","sidebarTitle":"Metrics","icon":"activity","href":"/documentation/agentruntime/sandbox-management/get-metrics"},{"title":"Expose a web service","sidebarTitle":"Web Services","icon":"link","href":"/documentation/agentruntime/sandbox-management/get-host-url"},{"title":"Change runtime settings","sidebarTitle":"Configure","icon":"sliders-horizontal","href":"/documentation/agentruntime/sandbox-management/configure-sandbox"}]},{"group":"Access","icon":"key-round","pages":[{"title":"Connect to a runtime","sidebarTitle":"Connect","icon":"log-in","href":"/documentation/agentruntime/ssh-access/overview"},{"title":"Open the web terminal","sidebarTitle":"Terminal","icon":"app-window","href":"/documentation/agentruntime/ssh-access/web-terminal"},{"title":"SSH","sidebarTitle":"SSH","icon":"key-square","href":"/documentation/agentruntime/ssh-access/ssh"}]},{"group":"Code","icon":"code","pages":[{"title":"Run code","sidebarTitle":"Overview","icon":"braces","href":"/documentation/agentruntime/code-execution/overview"},{"title":"Run code","sidebarTitle":"Run","icon":"play","href":"/documentation/agentruntime/code-execution/run-code"},{"title":"Stream code output","sidebarTitle":"Stream","icon":"waves","href":"/documentation/agentruntime/code-execution/stream-code"},{"title":"Keep state across runs","sidebarTitle":"Context","icon":"package-plus","href":"/documentation/agentruntime/code-execution/create-context"}]},{"group":"Command","icon":"terminal","pages":[{"title":"Run a command","sidebarTitle":"Overview","icon":"command","href":"/documentation/agentruntime/command-execution/overview"},{"title":"Run a shell command","sidebarTitle":"Run","icon":"square-play","href":"/documentation/agentruntime/command-execution/run-command"},{"title":"Stream command output","sidebarTitle":"Stream","icon":"signal","href":"/documentation/agentruntime/command-execution/streaming"},{"title":"Run in the background","sidebarTitle":"Background","icon":"clock","href":"/documentation/agentruntime/command-execution/background"}]},{"group":"File","icon":"file","pages":[{"title":"Read a file","sidebarTitle":"Read","icon":"file-text","href":"/documentation/agentruntime/file-operations/read-file"},{"title":"Write a file","sidebarTitle":"Write","icon":"file-pen","href":"/documentation/agentruntime/file-operations/write-file"},{"title":"List files","sidebarTitle":"List","icon":"folder","href":"/documentation/agentruntime/file-operations/list-files"},{"title":"Upload a file","sidebarTitle":"Upload","icon":"upload","href":"/documentation/agentruntime/file-operations/upload-file"},{"title":"Download a file","sidebarTitle":"Download","icon":"download","href":"/documentation/agentruntime/file-operations/download-file"},{"title":"Create a directory","sidebarTitle":"Create","icon":"folder-plus","href":"/documentation/agentruntime/file-operations/make-directory"},{"title":"Move a file","sidebarTitle":"Move","icon":"move","href":"/documentation/agentruntime/file-operations/move-file"},{"title":"Copy a file","sidebarTitle":"Copy","icon":"copy","href":"/documentation/agentruntime/file-operations/copy-file"},{"title":"Delete a file","sidebarTitle":"Delete","icon":"file-x-2","href":"/documentation/agentruntime/file-operations/delete-file"},{"title":"Find files","sidebarTitle":"Find","icon":"search","href":"/documentation/agentruntime/file-operations/find-files"},{"title":"Search and replace","sidebarTitle":"Replace","icon":"pencil","href":"/documentation/agentruntime/file-operations/search-and-replace"},{"title":"Watch a directory","sidebarTitle":"Watch","icon":"eye","href":"/documentation/agentruntime/file-operations/watch-directory"},{"title":"Get file info","sidebarTitle":"Info","icon":"file-search","href":"/documentation/agentruntime/file-operations/get-file-info"},{"title":"Set permissions","sidebarTitle":"Permissions","icon":"lock","href":"/documentation/agentruntime/file-operations/set-permissions"},{"title":"Change the owner","sidebarTitle":"Owner","icon":"user","href":"/documentation/agentruntime/file-operations/change-owner"}]},{"group":"Git","icon":"git-branch","pages":[{"title":"Use Git","sidebarTitle":"Overview","icon":"folder-git-2","href":"/documentation/agentruntime/git-operations/overview"},{"title":"Clone a repository","sidebarTitle":"Clone","icon":"hard-drive-download","href":"/documentation/agentruntime/git-operations/git-clone"},{"title":"See what changed","sidebarTitle":"Status","icon":"list-checks","href":"/documentation/agentruntime/git-operations/git-status"},{"title":"Stage files","sidebarTitle":"Add","icon":"file-plus","href":"/documentation/agentruntime/git-operations/git-add"},{"title":"Commit changes","sidebarTitle":"Commit","icon":"git-commit-horizontal","href":"/documentation/agentruntime/git-operations/git-commit"},{"title":"Push changes","sidebarTitle":"Push","icon":"arrow-up-to-line","href":"/documentation/agentruntime/git-operations/git-push"},{"title":"Pull changes","sidebarTitle":"Pull","icon":"arrow-down-to-line","href":"/documentation/agentruntime/git-operations/git-pull"},{"title":"Fetch updates","sidebarTitle":"Fetch","icon":"cloud-download","href":"/documentation/agentruntime/git-operations/git-fetch"},{"title":"List branches","sidebarTitle":"Branches","icon":"list-tree","href":"/documentation/agentruntime/git-operations/git-list-branches"},{"title":"Switch branches","sidebarTitle":"Checkout","icon":"arrow-right-left","href":"/documentation/agentruntime/git-operations/git-checkout"},{"title":"Create a branch","sidebarTitle":"Branch","icon":"split","href":"/documentation/agentruntime/git-operations/git-create-branch"},{"title":"Delete a branch","sidebarTitle":"Delete","icon":"scissors","href":"/documentation/agentruntime/git-operations/git-delete-branch"}]},{"group":"Storage","icon":"database","pages":[{"title":"Storage Mounts","sidebarTitle":"Mounts","icon":"hard-drive","href":"/documentation/agentruntime/storage-mounts"}]},{"group":"Snapshot","icon":"camera","pages":[{"title":"Snapshots","sidebarTitle":"Overview","icon":"images","href":"/documentation/agentruntime/snapshots/overview"},{"title":"Save a snapshot","sidebarTitle":"Save","icon":"save","href":"/documentation/agentruntime/snapshots/create-snapshot"},{"title":"Restore a snapshot","sidebarTitle":"Restore","icon":"rotate-ccw","href":"/documentation/agentruntime/snapshots/create-from-snapshot"},{"title":"List snapshots","sidebarTitle":"List","icon":"list-video","href":"/documentation/agentruntime/snapshots/list-snapshots"},{"title":"Check a snapshot","sidebarTitle":"Info","icon":"inspect","href":"/documentation/agentruntime/snapshots/get-snapshot"},{"title":"Fork a runtime","sidebarTitle":"Fork","icon":"git-fork","href":"/documentation/agentruntime/snapshots/fork"},{"title":"Activate a snapshot","sidebarTitle":"Activate","icon":"toggle-right","href":"/documentation/agentruntime/snapshots/activate-deactivate"},{"title":"Delete a snapshot","sidebarTitle":"Delete","icon":"camera-off","href":"/documentation/agentruntime/snapshots/delete-snapshot"}]},{"title":"Templates","sidebarTitle":"Templates","icon":"layout-template","href":"/documentation/agentruntime/templates"},{"group":"PTY","icon":"square-terminal","pages":[{"title":"Open a shell","sidebarTitle":"Overview","icon":"monitor-play","href":"/documentation/agentruntime/pty-sessions/overview"},{"title":"Start a shell","sidebarTitle":"Start","icon":"circle-plus","href":"/documentation/agentruntime/pty-sessions/create-session"},{"title":"Send keystrokes","sidebarTitle":"Input","icon":"keyboard","href":"/documentation/agentruntime/pty-sessions/send-input"},{"title":"Read shell output","sidebarTitle":"Output","icon":"scroll-text","href":"/documentation/agentruntime/pty-sessions/stream-output"},{"title":"Drive a shell","sidebarTitle":"Drive","icon":"mouse-pointer","href":"/documentation/agentruntime/pty-sessions/session-handle"},{"title":"Resize or stop a shell","sidebarTitle":"Manage","icon":"list-todo","href":"/documentation/agentruntime/pty-sessions/manage-sessions"}]},{"group":"Browser Use","icon":"globe","pages":[{"title":"Browser Use","sidebarTitle":"Overview","icon":"navigation","href":"/documentation/agentruntime/browser-use/overview"},{"title":"Open a browser","sidebarTitle":"Sessions","icon":"chrome","href":"/documentation/agentruntime/browser-use/browser"},{"title":"Click and type","sidebarTitle":"Actions","icon":"mouse-pointer-click","href":"/documentation/agentruntime/browser-use/actions"},{"title":"Save the page","sidebarTitle":"Capture","icon":"image","href":"/documentation/agentruntime/browser-use/capture"},{"title":"Watch page events","sidebarTitle":"Events","icon":"zap","href":"/documentation/agentruntime/browser-use/events"},{"title":"Keep a login","sidebarTitle":"State","icon":"archive","href":"/documentation/agentruntime/browser-use/contexts"},{"title":"Work the cookie jar","sidebarTitle":"Cookies","icon":"cookie","href":"/documentation/agentruntime/browser-use/cookies"},{"title":"Emulate a device","sidebarTitle":"Emulation","icon":"monitor-smartphone","href":"/documentation/agentruntime/browser-use/emulation"},{"title":"Control the network","sidebarTitle":"Network","icon":"shield-half","href":"/documentation/agentruntime/browser-use/network"},{"title":"Load an extension","sidebarTitle":"Extensions","icon":"puzzle","description":"Install an unpacked extension into a running browser","href":"/documentation/agentruntime/browser-use/extensions"},{"title":"Bring your own driver","sidebarTitle":"CDP endpoint","icon":"plug","href":"/documentation/agentruntime/browser-use/cdp"},{"title":"Ask a human","sidebarTitle":"Approvals","icon":"user-check","description":"Park an action until an operator approves or denies it","href":"/documentation/agentruntime/browser-use/approvals"},{"title":"Record a tab","sidebarTitle":"Recordings","icon":"video","href":"/documentation/agentruntime/browser-use/recordings"},{"title":"Save a browser profile","sidebarTitle":"Profiles","icon":"id-card","href":"/documentation/agentruntime/browser-use/profiles"},{"title":"Replay and fork","sidebarTitle":"Replay + fork","icon":"workflow","href":"/documentation/agentruntime/browser-use/replay-fork"}]},{"group":"Computer Use","icon":"monitor","pages":[{"title":"Computer Use","sidebarTitle":"Overview","icon":"layout-dashboard","href":"/documentation/agentruntime/computer-use/overview"},{"title":"See the screen","sidebarTitle":"Screen","icon":"scan","href":"/documentation/agentruntime/computer-use/screen"},{"title":"Human in the loop (HITL)","sidebarTitle":"Human in the loop","icon":"users","href":"/documentation/agentruntime/computer-use/human-in-the-loop"},{"title":"Control the pointer","sidebarTitle":"Control","icon":"pointer","href":"/documentation/agentruntime/computer-use/input"},{"title":"Open an app","sidebarTitle":"Apps","icon":"layout-grid","href":"/documentation/agentruntime/computer-use/windows-apps"},{"title":"Read the interface","sidebarTitle":"Inspect","icon":"scan-search","href":"/documentation/agentruntime/computer-use/accessibility"},{"title":"Record the screen","sidebarTitle":"Record","icon":"circle","href":"/documentation/agentruntime/computer-use/recording"},{"title":"Repair the desktop","sidebarTitle":"Session","icon":"history","href":"/documentation/agentruntime/computer-use/session"}]}]},{"group":"Support","icon":"life-buoy","pages":[{"title":"Support","sidebarTitle":"Support","icon":"circle-help","href":"/documentation/agentruntime/support"}]}]},{"tab":"Guides","icon":"compass","pages":[{"title":"Guides","href":"/guides/claude-code/overview"}]},{"tab":"API Reference","icon":"webhook","hidden":true,"pages":[{"title":"API Reference","href":"/api-reference/oauth2/server-metadata"}]}]},"basePath":"","title":"Bring your own driver - Gravix Layer","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["10e4515597"],"chunks":["BannerMarkdown-BOAJk9BH.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}