DeepSeek Harness Browser Use

Persistent Playwright browser tools and an interactive browser panel for DeepSeek Harness.

The plugin keeps one Chromium profile across turns, shares login state between tabs, lets agents operate pages through stable snapshot references, and lets a human temporarily take control from DSH Web.

Requirements

• DeepSeek Harness 0.1.1-rc.2 or a compatible release.
• Node.js 18 or newer.
• pnpm available to the dsh plugin command.
• A Chromium or Chrome executable on the Host machine.
• A model that accepts image input if browser_screenshot is used.

The package depends on playwright-core; it does not download a browser automatically.

Install

Install from npm into the profile that runs DSH Web:

dsh plugin --profile web add @syncended/dsh-browser-use

Or install a local checkout while developing:

git clone https://github.com/syncended/deepseek-harness-browser-use.git
cd deepseek-harness-browser-use
pnpm install
pnpm check
dsh plugin --profile web add -w "$PWD"

Restart the existing DSH Host after installation:

dsh --profile web --no-open

Do not start a second Host for the same profile. Refresh DSH Web after the Host is ready.

Connect and use

1. Open or create a DSH session.
2. Open the Browser tab in the conversation details pane.
3. Enter an HTTP or HTTPS address in the toolbar.
4. Use the control indicator at the bottom of the panel to take or release human control.
5. Ask the agent to browse; the same tabs and profile remain available on later turns.

Login state is shared by all tabs in the configured browser profile. The durable profile is stored under the DSH home directory, not in this repository.

Agent tools

• browser_status — inspect process state, control owner, and tabs.
• browser_tabs — list, create, select, or close tabs.
• browser_navigate — navigate the active tab.
• browser_snapshot — receive visible interactive elements with one-shot references.
• browser_click — click a reference from the latest snapshot.
• browser_type — replace the value of a text field.
• browser_press — send a Playwright key or shortcut.
• browser_scroll — scroll by pixel deltas.
• browser_screenshot — capture the active viewport as an image attachment.

Take a fresh browser_snapshot after every click, type, key press, navigation, or scroll. Old snapshot references are intentionally rejected.

Password, payment, and one-time-code fields require human control and cannot be filled through browser_type.

Configuration

The package adds this default Host entry through cordis.patch.yml:

- id: browser-use
  name: '@syncended/dsh-browser-use'
  config:
    profile: default
    headless: true
    noSandbox: false
    viewportWidth: 1280
    viewportHeight: 800
    screenshotQuality: 70
    operationTimeoutMs: 20000
    humanLeaseTtlMs: 15000

Override only the required values in the profile's cordis.patch.yml. Useful options include:

Option	Purpose
profile	Durable browser-profile name.
headless	Run Chromium without a desktop window.
executablePath	Use a specific Chromium or Chrome binary.
noSandbox	Add Chromium's --no-sandbox flag.
viewportWidth, viewportHeight	Default page viewport.
screenshotQuality	JPEG quality from 1 to 100.
operationTimeoutMs	Navigation and action timeout.
humanLeaseTtlMs	Time before an inactive human-control lease expires.

Restart the Host after changing Host configuration.

Security

• Browser profiles can contain authenticated sessions. Protect the DSH home directory as credential material.
• Remote Web control follows the Host's DSH trustedHosts policy. Do not expose DSH Web to untrusted networks.
• Keep Chromium's sandbox enabled. Set noSandbox: true only inside an appropriately isolated container where Chromium runs as root.
• Human control blocks agent actions until the lease is released or expires.
• Use a separate profile for untrusted browsing or separate identities.

Troubleshooting

Chromium does not start

Install Chromium or Chrome on the Host and set executablePath to its absolute path. On Linux, also verify that the browser's shared-library dependencies are installed.

The Browser tab is missing

Confirm that the package is installed in the profile serving DSH Web, restart that Host, and refresh the page.

An action says that human control is active

Release control in the Browser panel or wait for humanLeaseTtlMs to expire.

A click or type reference is rejected

Call browser_snapshot again. References are valid only for the page state that produced them.

A site blocks headless Chromium

This plugin does not attempt to bypass anti-bot controls. Use the site's supported API or complete the operation manually where permitted.

Update and remove

dsh plugin --profile web add @syncended/dsh-browser-use@latest
dsh plugin --profile web remove @syncended/dsh-browser-use

Restart the Host after either command.

Development

pnpm install
pnpm check
npm pack --dry-run

License

MIT