Tianyu209/dsh-browser-companion
41Last commit Aug 15, 2026
dsh-browser-companion DSH plugin
dsh-browser-companion gives your DeepSeek Harness agent a dedicated visible browser window. It allows you to watch agent actions, perform logins manually, and maintain persistent browser state across sessions.
How to install the dsh-browser-companion DSH plugin
dsh plugin --profile web add dsh-browser-companionCopying does not run this command. Review the repository and version before installing the dsh-browser-companion DSH plugin.
dsh-browser-companion DSH plugin data source
dsh-browser-companion DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-browser-companion DSH plugin can do
- Persistent browser profile with cookies and login state
- Visible window mode (non-headless) for human monitoring
- Human-in-the-loop login: agent opens a window, you enter credentials
- Agent tools: open, click, type, screenshot, scroll, tabs, etc.
- Local vision model integration via `browser_see` for image understanding
- Security guard prevents agent from typing into password fields
Where the dsh-browser-companion DSH plugin fits
- Let an agent automate web tasks while you watch the real browser
- Perform manual logins on sites that block automated authentication
- Maintain cookies and sessions across agent restarts for long-running tasks
- Use the agent to fill forms and navigate, but keep passwords secret
- Integrate with local vision models to analyze visual layouts
Who the dsh-browser-companion DSH plugin is for
- DSH users who want a visible browser for their agents
- Developers building automation that requires human-in-the-loop login
- Users who need persistent browser state across agent sessions
dsh-browser-companion DSH plugin limitations
- Headless mode is disabled by default; cannot run in fully headless environments without modification
- Requires local installation of agent-browser and Chromium
- Vision model (`browser_see`) requires a separate local vision model endpoint
- Login state is stored in a local profile; no built-in encryption for cookie storage yet
dsh-browser-companion DSH plugin: from the repository README
Quoted from the Tianyu209/dsh-browser-companion README, the upstream source of the dsh-browser-companion DSH plugin. Copyright remains with the original authors.
A personal DeepSeek Harness (DSH) browser plugin. It gives your agent a **dedicated, persistent, visible browser**: - You can watch what the agent is doing in a real browser window. - Logins are done by you in the popup window; passwords and OAuth secrets never pass through the agent. - Cookies and login state are saved in the same profile, so logins persist across restarts. ## Features - ✅ Persistent browser profile (cookies / localStorage / login state) - ✅ Visible window mode (default `headless: false`) - ✅ Human-in-the-loop login: `browser_login` opens a window and you type your password / complete OAuth yourself - ✅ Agent tools: open, snapshot, click, type, press, screenshot, see, select, check, upload, hover, scroll, tabs, status - ✅ Security guard: `browser_type` refuses to fill password fields - ✅ `browser_see` uses a local vision model (OpenAI-compatible) so the agent can understand images / visual layouts when needed - ✅ Based on [agent-browser](https://github.com/vercel-labs/agent-browser), so the hard browser automation is battle-tested ## Out-of-the-box The plugin works with zero configuration for basic browsing: - Uses the bundled browser (agent-browser's Chrom
Read the full READMERepository license: MIT
dsh-browser-companion DSH plugin questions
How do I install dsh-browser-companion?
First install agent-browser globally: `npm install -g agent-browser` and run `agent-browser install` to download Chromium. Then add the plugin: `dsh plugin --profile web add dsh-browser-companion`. Restart DSH with `dsh web`. If you use pnpm, you may need to allow build scripts for agent-browser in pnpm-workspace.yaml.
Does the agent see my passwords?
No. The agent is instructed never to type into password fields. Logins are performed by you in the visible browser window that the agent opens. Your passwords and OAuth secrets never pass through the agent.
Can I run this plugin in headless mode?
By default the plugin runs in visible window mode (headless: false). You can change the `headless` config option to true in the DSH WebUI plugin settings, but some features like `browser_login` rely on a visible window for manual interaction.
How does the agent see the page content?
The plugin uses `browser_snapshot` to get an accessibility tree for fast, free text-based page understanding. When visual analysis is needed (images, layout), `browser_see` uses a local vision model (OpenAI-compatible) that you must configure separately.
Does the plugin save my browsing state?
Yes. The plugin uses a persistent browser profile (default: `~/.dsh/browser-profile`). Cookies, local storage, and login state are saved across sessions. You can change the profile path in the plugin settings.