Skip to content

docs: add Usage section with hands + deepdive + raw CDP examples#12

Open
askalf wants to merge 1 commit into
masterfrom
docs/readme-usage
Open

docs: add Usage section with hands + deepdive + raw CDP examples#12
askalf wants to merge 1 commit into
masterfrom
docs/readme-usage

Conversation

@askalf
Copy link
Copy Markdown
Owner

@askalf askalf commented May 25, 2026

Renames the existing ## Use it heading to ## Usage and adds three caller-focused subsections requested in OPS-93F1996C6F064F6EB9BDEA:

  • Connect from handschromium.connectOverCDP snippet shaped like hands/src/tools/read-page.ts, with a BROWSER_BRIDGE_URL env knob for swapping the bridge address in a shared docker network.
  • Connect from deepdiveBrowserSession.start() variant that swaps deepdive's local chromium.launch() for chromium.connectOverCDP(). Notes that deepdive's existing STEALTH_ARGS are redundant when the bridge handles the launch.
  • Raw CDPcurl /json/version to fetch webSocketDebuggerUrl, plus a minimal Page.navigate JSON-RPC frame so callers without Playwright/Puppeteer can see the actual wire format.

All snippets are grounded in the bridge's own launch.mjs (port 9222 via socat, /json/version healthcheck endpoint) and the current code in askalf/hands and askalf/deepdive on master.

Closes OPS-93F1996C6F064F6EB9BDEA

Renames the existing Use it heading to Usage and adds three subsections
showing the two known callers (hands, deepdive) connecting via
chromium.connectOverCDP, plus a raw CDP example demonstrating the JSON-RPC
wire format for callers without a Playwright/Puppeteer dependency.

Closes OPS-93F1996C6F064F6EB9BDEA
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