imroc/dsh-embedded-browser
dsh-embedded-browser runs a browser inside the DSH host with one persistent tab per session: the agent drives it with twelve lazily-published browser_embedded_* tools while the human watches or takes over the same tab from a sidebar panel, so QR-code, SMS and CAPTCHA logins happen once in the UI and stay logged in.
dsh-embedded-browser exists for one problem the README states plainly: agents run on machines with no display, but the sites they need are behind a login, and a headless browser cannot scan a QR code, type an SMS code or solve a CAPTCHA. The plugin runs a browser inside the DSH host with one tab per session and two control planes: the AI speaks CDP on its tab while the human sees and drives that same tab from a right-sidebar panel that opens on demand, so a login performed in the UI is exactly the session the agent keeps using - and because all sessions share one persistent profile, every other session is logged in too. Twelve browser_embedded_* tools are published lazily rather than at load, because their schemas are billed on every request: they stay off the tool list until something proves the model is doing browser work, such as a successful skill call naming browser-use or the /browser-use gesture. Copying cookies or storageState into a container is explicitly not the approach, since device-bound credentials, fingerprints and WebAuthn do not transfer.
Install
dsh plugin --profile web add dsh-embedded-browserCopied verbatim from the README's install block (dsh plugin --profile web remove dsh-embedded-browser is the documented uninstall). The README also documents dsh plugin --profile web add github:imroc/dsh-embedded-browser. npm package dsh-embedded-browser at 0.3.0 (registry check 2026-10-16; the registry repository field resolves back to this repo).
Compatibility
Renamed in 0.3.0: up to 0.2.0 the plugin was dsh-browser-panel, its tools were browser_panel_*, its routes lived under /api/dsh-browser-panel/* and its profile under $DSH_HOME/browser-panel/profile. The package, repository and all of those names changed together so the tool prefix now matches the package name; pointing profileDir at the old directory keeps the logins of a 0.2.0 install. The README is explicit about the two halves a plugin needs in the profile - a dependency so its code is in the profile's node_modules, and an entry in dsh.profile.bundles so the patch inserting its row is applied - and about the profile being shared, which is what makes one human login serve every session.
Details
- Repo: imroc/dsh-embedded-browser
- Category: Tools & Capabilities
- Stars: 0
- Version: GitHub repo imroc/dsh-embedded-browser (0*); npm package dsh-embedded-browser at 0.3.0 (registry check 2026-10-16; the registry repository field resolves back to this repo). MIT licensed; JavaScript; created 2026-09-14. English README with a README.zh.md Chinese translation.
Alternatives
1321928757/dsh-api-kit · 1321928757/dsh-mysql · 1624318455/dsh-plugin-tavily