Skip to content

bill9109/dsh-webbridge

30Last commit Aug 14, 2026

dsh-webbridge DSH plugin

dsh-webbridge is an adapter plugin that exposes the Kimi WebBridge local daemon as model-facing tools on DeepSeek Harness. It enables the model to operate your own browser—with preserved sessions and open tabs—instead of a headless one. The plugin itself ships no browser-driving code; it relies on the separately installed Kimi WebBridge daemon and browser extension.

How to install the dsh-webbridge DSH plugin

dsh plugin --profile web add github:bill9109/dsh-webbridge

Copying does not run this command. Review the repository and version before installing the dsh-webbridge DSH plugin.

dsh-webbridge DSH plugin data source

dsh-webbridge DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-webbridge DSH plugin can do

  • Provides 11 tools: navigate, find_tab, snapshot, click, fill, evaluate, screenshot, list_tabs, network, close_tab, close_session
  • One task uses one session name to group tabs, keeping tasks isolated
  • Operates the user's real browser with logins, cookies, and live sessions
  • Local-first: daemon runs on your machine; browser state never leaves it
  • No KV-cache burden: browser state lives outside the model request

Where the dsh-webbridge DSH plugin fits

  • Fill and submit forms on websites that require the user's login session
  • Navigate to a specific page, read its content via snapshot, and perform actions
  • Capture screenshots of pages or elements for the model to analyze
  • Inspect network activity of a page to debug or extract data
  • Manage multiple tabs within a task and close them when the user requests

Who the dsh-webbridge DSH plugin is for

  • Developers who want to give their DSH model access to a real browser environment
  • Users who need to automate web tasks that depend on existing sessions and cookies

dsh-webbridge DSH plugin limitations

  • Requires the Kimi WebBridge daemon and browser extension to be installed separately
  • Sites that strictly check event.isTrusted (e.g., banking portals, captchas) may ignore clicks and fills
  • Cross-origin iframes are not supported—tools operate on the top frame only
  • Screenshots return a file path, not an image; the model must use a Read tool to view
  • Restarting the Kimi WebBridge daemon clears all tab groups and sessions

dsh-webbridge DSH plugin: from the repository README

Quoted from the bill9109/dsh-webbridge README, the upstream source of the dsh-webbridge DSH plugin. Copyright remains with the original authors.

**Install:** `dsh plugin --profile web add github:bill9109/dsh-webbridge` **A DeepSeek Harness host plugin: it bridges Kimi WebBridge's local daemon into eleven `webbridge_*` model tools, so the model operates **your own browser** — logins, cookies, and already-open tabs included — instead of a headless one.** [English](README.md) | [中文](README.zh.md) ## Why this exists When a model task has to touch a real website — a page behind your login, carrying your session and your already-open tabs — a headless browser cannot help: it holds none of your state and would ask you to authenticate all over again. `dsh-webbridge` exists to hand the model control of **your real browser** while keeping that browser state strictly on your machine, never inside a model request. It ships **no browser-driving code of its own**: the actual work is done by the Kimi WebBridge daemon and browser extension. This plugin only translates that capability into model-facing tools on the DSH side. ## Features - **Real browser, not headless**: logins, cookies, and live sessions preserved - **Eleven model tools**: navigate / find_tab / snapshot / click / fill / evaluate / screenshot / list_tabs / network /

Read the full READMERepository license: BSD-3-Clause

dsh-webbridge DSH plugin questions

How do I install dsh-webbridge?

Run `dsh plugin --profile web add github:bill9109/dsh-webbridge` in your terminal. This installs the plugin into the `web` profile. You must also have the Kimi WebBridge daemon and browser extension installed separately; without them the tools will fail with `daemon_unreachable`.

What tools does dsh-webbridge provide?

It provides 11 tools: webbridge_navigate, webbridge_find_tab, webbridge_snapshot, webbridge_click, webbridge_fill, webbridge_evaluate, webbridge_screenshot, webbridge_list_tabs, webbridge_network, webbridge_close_tab, and webbridge_close_session. These tools let the model control your real browser in a session-based manner.

Can I use dsh-webbridge without the Kimi WebBridge daemon?

No. The plugin is an adapter and requires the Kimi WebBridge daemon and browser extension to be installed and running. If the daemon is not running, all tool calls return a `daemon_unreachable` error. You can start the daemon with `~/.kimi-webbridge/bin/kimi-webbridge start`.

Why are my clicks or fills not working on some websites?

Some websites strictly check the `event.isTrusted` property to distinguish synthetic events from real user interactions. The daemon's synthetic events may be ignored on such sites (e.g., banking portals, captchas). The daemon's CDP escape hatch is not yet exposed as a tool.

How do I view screenshots taken by the model?

The screenshot tool returns a file path on the local machine, not an image. The model must use a Read tool (e.g., `read_file` or similar) to view the image at that path. The daemon writes screenshots to a temporary directory.