AI Agent Hub
Back to plugins
🧰

dsh-cdp-browser

Web Tools Updated 2026.08.25

Run the following command in DeepSeek Harness:

dsh plugin install zaiwenJ/dsh-cdp-browser

Paste the following prompt into your AI chat to install this plugin:

Run dsh plugin install zaiwenJ/dsh-cdp-browser in your terminal to add the package from https://github.com/zaiwenJ/dsh-cdp-browser to the current DeepSeek Harness profile.

About this plugin

In the DeepSeek Harness sandbox, the traditional approach of spawning a browser process and piping its stdio keeps hitting EPERM/EINVAL because the sandbox forbids pipe operations. dsh-cdp-browser takes a different route: it connects to a Chrome or Edge instance the user has already launched via the Chrome DevTools Protocol. Browser control becomes plain network I/O, sidestepping all child-process and pipe restrictions, and the model no longer needs per-call human approval for visual checks.

The plugin relies solely on Node 22 built-ins—global fetch, WebSocket, and zlib PNG decoding—with zero npm dependencies and no child_process. It ships five tools: list open tabs (cdp_status), open or reuse a page (cdp_open), evaluate page-level JavaScript (cdp_eval), navigate and capture a PNG screenshot (cdp_shot), and the centerpiece, cdp_assert—scripted interaction layered with deterministic pixel, CSS, DOM, and JS assertions that produce a pass/fail report. Pixel checks include gradient-aware sampling and tolerance-based colour matching to avoid false positives in transition zones.

It is aimed at developers who need browser end-to-end verification, visual regression testing, or simply want the model to inspect page rendering inside a confined Harness environment. After the one-time manual step of launching a CDP-enabled browser, every subsequent visual check runs silently with no human involvement.

Use Cases

  • Pixel-level visual regression testing of web apps inside the Harness sandbox
  • Letting the model open pages, run scripts, and screenshot for rendering verification
  • Deterministic pass/fail assertions on DOM, CSS, and pixels via cdp_assert

Best For

  • Developers needing browser-based visual verification inside the DeepSeek sandbox
  • CI pipelines where the model finishes visual checks without per-call approval
  • Plugin authors on Node 22+ who want a zero-npm-dependency browser toolchain