dsh-browser-bridge v0.1.0

dsh-browser-bridge v0.1.0

A DeepSeek Harness plugin + browser extension: gives the agent the ability to read and control your browser (an analog of Kimi WebBridge / Claude browser tools).

Features

• 13 tools for the agent: browser_status, list_tabs, activate_tab, navigate, snapshot, read_page, click, type, press, scroll, wait, screenshot, eval
• WebSocket bridge at ws://127.0.0.1:3080/bridge (port/path configurable)
• Screenshots are saved to ~/.dsh/browser-bridge/ (the result returns a path, no base64)
• Chrome/Edge extension (Manifest V3): background + content script, auto-reconnect, bridge URL configurable via chrome.storage
• Zero dependencies: the WebSocket server (RFC 6455) is hand-rolled
• All code is pure ASCII (robust against Windows encoding issues)

Installation

# on the machine with DSH
powershell -ExecutionPolicy Bypass -File install-plugin.ps1

Then install the extension from the extension/ folder via chrome://extensions (Developer mode) and restart dsh web.

Details and troubleshooting: INSTALL.md

What's inside

Path	Purpose
lib/index.js	Plugin entry point (registers tools and the WS route)
lib/ws.js	Minimal RFC 6455 WebSocket server
lib/bridge.js	Bridge: single client, commands with timeout, pings, BridgeError
lib/tools.js	13 tools for the agent
extension/	Manifest V3 extension (background, content, popup, options)
install-plugin.ps1	Idempotent installer (BOM-free)
INSTALL.md	Russian-language guide + troubleshooting
test/	Automated tests (53 assertions) and a live extension test

Notes

• Built for Windows (tested on Windows 10/11 and Windows Server 2019).
• On Windows Server the native folder picker dialog may fail — see the troubleshooting section in INSTALL.md (the directory-picker-browse patch).
• Not published to npm; distribution happens through this repository.