zaiwenJ/dsh-cdp-browser

README excerpt

dsh-cdp-browser Zero-spawn browser automation + pixel-level visual verification as a DeepSeek Harness plugin. Drives an already-running Chrome/Edge over CDP using Node built-ins only: global fetch + global WebSocket (Node ≥ 22) + zlib PNG decode. No child process , no npm dependencies, no per-use approval. Why zero-spawn Plugins that spawn an engine and pipe its stdio (e.g. modlens) collide with the harness sandbox's pipe ban (EPERM/EINVAL) on every call. Connecting to a browser the user started themselves is plain network I/O — allowed in confined mode. The one manual step (launching the browser) happens outside the harness, so the model never needs approval again for visual checks. Setup (once) 1. Install into the profile (done via dsh plugin --profile web add file: ). 2. Start your browser with CDP (the provided edge-debug.cmd does this): 3. Restart the Web GUI. The cdp tools appear in the next session. Tools Tool What it does cdp status List tabs/targets of the CDP browser + browser version cdp open Open (or reuse) a tab for a url; returns target id cdp eval Evaluate JS in a page ( awaitPromise , returnByValue ) cdp shot Navigate + PNG screenshot, saved to an absolute path cdp …

Category