Clizo1209/dsh-playwright-browser
80Last commit Aug 14, 2026
dsh-playwright-browser DSH plugin
dsh-playwright-browser provides a persistent browser controller with accessibility-oriented snapshots, semantic locators, screenshots, navigation history, and explicit tab management. It registers ten browser_* tools in the DSH tool registry, allowing agents to interact with web pages programmatically.
How to install the dsh-playwright-browser DSH plugin
dsh plugin --profile web add dsh-playwright-browserCopying does not run this command. Review the repository and version before installing the dsh-playwright-browser DSH plugin.
dsh-playwright-browser DSH plugin data source
dsh-playwright-browser DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-playwright-browser DSH plugin can do
- Persistent browser context with stable tab identifiers
- Accessibility and visible-text snapshots after interactions
- Semantic locators (role, label, text, CSS, and shorthand forms)
- Navigation actions: open, navigate, back, forward, reload
- Keyboard input, click, fill, and wait operations
- PNG screenshot capture with configurable output directory
- Lazy browser startup with fallback to installed Chrome or Edge
- Abort-aware page operations with Cordis lifecycle cleanup
Where the dsh-playwright-browser DSH plugin fits
- Automating web application testing with DSH agents
- Scraping dynamic content that requires JavaScript execution
- Filling and submitting forms as part of a workflow
- Taking screenshots of web pages for documentation or monitoring
- Navigating multi-step user flows in a controlled browser environment
Who the dsh-playwright-browser DSH plugin is for
- Developers building AI agents that need browser access
- DSH users who want to extend their agent's capabilities with web automation
dsh-playwright-browser DSH plugin limitations
- Requires Node.js ^22.19.0 or >=24.0.0 and a DSH profile
- No arbitrary page JavaScript evaluation; only pre-defined actions
- Browser installation is not automatically downloaded; must be pre-installed or configured
- Currently tested against DSH 0.1.0-rc.6; may need updates for newer DSH versions
- URLs with embedded credentials are rejected
dsh-playwright-browser DSH plugin: from the repository README
Quoted from the Clizo1209/dsh-playwright-browser README, the upstream source of the dsh-playwright-browser DSH plugin. Copyright remains with the original authors.
Semantic, multi-tab browser automation for [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/deepseek-harness), powered by Playwright. The plugin gives a DSH agent a persistent browser controller, accessibility-oriented snapshots, semantic locators, screenshots, navigation history, and explicit tab management. It is behaviorally inspired by the Codex Browser skill, but contains no Codex runtime code and does not depend on OpenAI browser bindings. > [!IMPORTANT] > DSH is currently a developer preview. This plugin is tested against the DSH `0.1.0-rc.6` package line and may need compatibility updates as DSH evolves. ## Features - Ten native `browser_*` tools registered in the DSH tool registry. - Reusable browser context with stable tab identifiers. - Fresh bounded accessibility or visible-text snapshots after interactions. - Semantic locators such as `role=button|Save`, `label=Email`, and `text=Settings`. - Snapshot-friendly role shorthand such as `button|Save` and `textbox|Email`. - Back, forward, reload, keyboard input, waits, and PNG screenshots. - Lazy browser startup with fallback from Playwright Chromium to installed Chrome or Edge. - Abort-aware page operations and C
Read the full READMERepository license: MIT
dsh-playwright-browser DSH plugin questions
How do I install dsh-playwright-browser?
Run `dsh plugin --profile <profile> add dsh-playwright-browser` from the npm registry. Alternatively, you can clone the repository, run `npm pack`, and then use `dsh plugin --profile <profile> add ./dsh-playwright-browser-<version>.tgz` to install from a local tarball. Make sure you have a DSH profile set up first.
Which browsers are supported?
Playwright Chromium, Firefox, and WebKit are all supported. You can also use Google Chrome or Microsoft Edge by specifying the `channel` option. If you want to use a custom browser executable, set the `executablePath` option in the configuration.
Can I take screenshots with this plugin?
Yes, the plugin provides a `browser_screenshot` tool that saves a PNG screenshot of the current page and returns its absolute path. You can configure the output directory using the `screenshotDir` option (default is `.dsh-browser/screenshots`).
What locators can I use to interact with elements?
The plugin supports semantic locators such as `role=button|Save`, `label=Email`, `placeholder=Search`, `text=Settings`, `testid=submit`, `css=#legacy-button`, and shorthand forms like `button|Save`. These are used in the `browser_click` and `browser_fill` tools.
Does the plugin run in headless mode?
Yes, by default the browser runs in headless mode. You can change this by setting `headless: false` in the plugin configuration. Headless mode is useful for automated testing and server environments where a visible window is not needed.