dsh-browser

Browser automation for DeepSeek Harness: a Playwright-powered browser_* tool family so the agent can drive real web pages — fill forms, click through flows, scrape SPA content, and take screenshots it can then view with read_image.

Install

dsh plugin --profile <name> add dsh-browser

The plugin depends on playwright-core (bundled with the package) and needs a Chromium-based browser. It tries chromium, then chrome, then msedge channels automatically; if none is found:

npx playwright install chromium

or configure launch.executablePath / launch.channel in the plugin config.

Tools

| Tool | Purpose | |---|---| | browser_open | Open (or reuse) the browser, optionally navigate to a URL | | browser_navigate | Navigate the current page and wait for load | | browser_click | Click an element by CSS selector | | browser_type | Type text into an input (optionally press Enter) | | browser_select | Select option(s) in a <select> | | browser_screenshot | Capture a PNG to <workspace>/browser-screenshots/; view it with read_image | | browser_eval | Evaluate JavaScript in the page, return JSON | | browser_get_text / browser_get_html | Read visible text or outer HTML | | browser_wait | Wait for slow pages / lazy content | | browser_close | Close the browser (reopenable by any tool) | | browser_install | Explain or verify browser availability |

The browser persists across tool calls — open once, drive many times, close when done.

Configuration

| Field | Default | Meaning | |---|---|---| | launch.executablePath | — | Absolute path to a browser binary (takes precedence) | | launch.channel | auto (chromium → chrome → msedge) | Browser channel | | launch.navigationTimeoutMs | — | Default navigation/action timeout | | launch.viewport | 1280×800 | Page viewport | | screenshotDir | browser-screenshots | Screenshot directory under the workspace |

# profile cordis.patch.yml
- id: browser
  config:
    launch:
      channel: chrome
      navigationTimeoutMs: 30000

Notes

• Runs headless by default; a headed mode may come later.
• Screenshots land in the calling agent's workspace so the model can read them with read_image.

License

MIT