README
dsh-webbridge — Model tools that drive your REAL browser via Kimi WebBridge
Install: dsh plugin --profile web add github:omdsh-dev/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.
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 / close_tab / close_session
- One task = one tab group: a
sessionname groups tabs, keeping tasks cleanly isolated - Local-first: the daemon runs on your machine; browser state never leaves it
- No KV-cache burden: browser state lives outside the model request
Usage
Prerequisites (required!)
This plugin is an adapter — without the pieces below, browser control does not work. You must install Kimi WebBridge separately (an independent product by Moonshot AI; this plugin contains none of its code). Full install and browser-extension setup instructions live on Kimi's official pages: feature page / help center. In short:
# 1. Install the daemon:
curl -fsSL https://cdn.kimi.com/webbridge/install.sh | bash
# 2. Install the Kimi WebBridge browser extension and let it connect to the
# daemon (search "Kimi WebBridge" in the Chrome Web Store), then check:
kimi-webbridge status # expect "extension_connected": true
If the daemon is not running, tools fail loud with a daemon_unreachable
error that tells you to run ~/.kimi-webbridge/bin/kimi-webbridge start.
Model experience
| Tool | Purpose |
|---|---|
webbridge_navigate |
Open a URL (new tab or current), set the tab group label |
webbridge_find_tab |
Re-select a tab this task opened, or borrow the user's active tab |
webbridge_snapshot |
Read the page's accessibility tree (text + @e refs) |
webbridge_click |
Click an element by @e ref or CSS selector |
webbridge_fill |
Type into inputs / textareas / contenteditable editors |
webbridge_evaluate |
Run JS in the page (async supported) |
webbridge_screenshot |
Capture the page or one element to a file path |
webbridge_list_tabs |
List the tabs opened in the session |
webbridge_network |
Inspect network activity (start/stop/list/detail) |
webbridge_close_tab |
Close the current tab of the session |
webbridge_close_session |
Close ALL tabs of the session (clears the tab group) |
Session and closing rules (model contract)
These rules come from the upstream Kimi WebBridge skill and are part of the model contract:
- One task = one session = one tab group. Pick a
sessionname at the task's start and keep it on EVERY call — never switch mid-task. - Name it after the task, not the site (
camping-research, notkimi.com). group_titleis the human-readable group label, set on the FIRSTnavigateof the task, written in the user's language.- Closing is always user-initiated. Call
webbridge_close_sessionONLY when the user explicitly asks to close/clear the tabs; never close tabs automatically at the end of a task.
Configuration
The daemon address defaults to http://127.0.0.1:10086. The plugin accepts
no configuration today; the baseUrl seam exists for tests.
Install
The plugin is a DSH bundle (package.json declares dsh.bundle, and
cordis.patch.yml carries the patch). Install it into the web profile
with the standard dsh plugin mechanism — no DSH source changes and no
hand-written patch:
dsh plugin --profile web add github:omdsh-dev/dsh-webbridge
For a stable install, pin the version:
dsh plugin --profile web add github:omdsh-dev/dsh-webbridge#v0.0.3.
Internally the command runs pnpm add <spec> in the profile directory and
automatically appends packages that declare dsh.bundle to
dsh.profile.bundles. You can also clone it and install from a local path
(for development):
dsh plugin --profile web add /path/to/dsh-webbridge
The repository ships its build output (lib/), so the plugin works right
after installing — no build step needed. After installing, restart the Web
UI (production mode has no hot reload) and refresh the page — the
webbridge_* tools become available to the model.
Upgrade
dsh plugin --profile web update github:omdsh-dev/dsh-webbridge
For a local-path installation, run add again against the replacement
checkout, then restart the Web UI and refresh.
Uninstall
更多「网页与浏览器」插件
anysearch-dsh
作者 anysearch-team
为 DeepSeek Harness 提供的 AnySearch 网页搜索提供方与高级搜索工具。
dsh-find-plugin
作者 awesome-dsh-plugin
Find DSH plugins inside the agent — live GitHub dsh-plugin topic search, star-ranked / 会话内搜索发现 DSH 插件
fnos-dsh
作者 fnosp
DeepSeek Harness应用与harness插件 monorepo
modsearch
作者 liustack
🥇 The strongest free web search plugin for DeepSeek Harness, and the search bridge for every model without native web access. Free, no signup, no API key. Ask the web or X, get structured JSON evidence. | 🥇 全网最强的 DeepSeek Harness 免费联网搜索插件,免费免注册免 API key。为不能联网的模型补上搜索,问网页或 X,拿回结构化 JSON 证据(搜索、抓取、引用)。
