dsh-browser-control: Let DeepSeek Harness Drive Your Real Chrome
caob23/dsh-browser-control
A DSH plugin plus Chrome extension that lets AI agents drive your real, already-logged-in Chrome via CDP, inheriting cookies and sessions without any headless instance.
dsh-browser-control is a browser control setup made of a Chrome extension plus a DSH plugin that connects an AI agent to the browser you actually use every day. It skips the usual headless instance and fresh profile route, driving your existing tabs through the Chrome DevTools Protocol so login sessions and cookies carry over untouched and login walls or captchas rarely get in the way. Navigation, page reading, snapshot interaction trees, clicking and typing, tab management, JS execution, screenshots, console and network capture, PDF export, and device viewport switching are all exposed to the agent as browser_* tools, with every step visible on screen so you can take over with the mouse at any time. It needs no extra runtime and ships as a native DeepSeek Harness plugin with a settings card, status page, and cleanup button.
How to Install
dsh plugin --profile web add @caob23/dsh-browser-control- Category
- Tools & Capabilities
- Platform
- DSH Plugin
- Author
- caob23
- Distribution
- Plugin
dsh-browser-control Key Features
dsh-browser-control Repo Summary
What Does It Do?
DSH Browser Control is a DSH plugin for DeepSeek Harness that lets an AI agent drive your real Chrome browser the way a person would. Instead of launching a headless browser or a freshly downloaded instance, it drives your existing tabs through the Chrome DevTools Protocol, inheriting your login sessions and cookies while every step stays visible on screen. It is maintained by caob23 under the AGPL-3.0 license, written in JavaScript, and was last updated on 2026-09-04.
Core Features
- Real browser takeover: reuses the Chrome you already use, inherits all sessions and cookies, and rarely gets stuck on login walls or captchas.
- Native tool set: navigation, page text and HTML reading, snapshots that produce a ref interaction tree, clicking, typing, key presses, scrolling, tab management, arbitrary JS execution, and screenshots.
- Debugging and export: captures page console logs and HTTP request/response traffic, exports the current page to PDF, and switches between mobile, desktop, and custom device viewports.
- Visible and interruptible: actions appear on screen step by step, so you can take over with the mouse at any moment instead of running a black box.
- No extra runtime: needs no Node, npx, or Python environment, and downloads no additional hundreds of megabytes of browser binaries.
- Deep DSH integration: ships as a native plugin with a settings card, status page, and cleanup button, with the bridge enabled by default.
How to Use This Plugin?
After enabling it in DSH, load the companion Chrome extension (Chrome 116+ required; a whale icon with a breathing green dot means it is connected), which connects automatically to local port 9777. Then describe the task in natural language in the conversation, and the agent will call the browser_* tools to navigate, click, fill forms, and take screenshots. To turn off the default-enabled bridge, set enabled: false under browser-bridge.config in the DSH settings file; when debugging from a local directory, follow the official instructions and use the file: prefix, otherwise the package will not resolve correctly.
How to Troubleshoot This Plugin?
If the extension icon shows no breathing green dot, the WebSocket bridge between the Chrome extension and the plugin is not connected; first confirm the extension is loaded and the bridge is enabled on the DSH side. If startup reports that the plugin package cannot be resolved, it is usually because a local directory was added without the file: prefix and was treated as a link: protocol, so it never materialized at the top level of node_modules; follow the official instructions and use the correct prefix.
This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: caob23/dsh-browser-control. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.
DSH Plugin FAQ
