dsh-webbridge
In a curated listMaintenance: Activebill9109/dsh-webbridge
桥接 Kimi WebBridge 本地守护进程,让模型驱动用户真实浏览器(navigate/find_tab/snapshot/click/fill/evaluate/screenshot/list_tabs/network/close_tab/close_session)
$ dsh plugin add dsh-webbridgeInstall
dsh has no central install command — add this plugin’s entry (documented in its README) to your profile or patch config, then restart.
How installs work3
stars
0
forks
JavaScript
Language
BSD-3-Clause
License
2026-08-09
Created
2026-08-26
Last push
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
More in Web & Browser
anysearch-dsh
by anysearch-team
AnySearch web search provider and advanced search tools for DeepSeek Harness (DSH)
dsh-find-plugin
by awesome-dsh-plugin
In-agent plugin discovery: live GitHub repository search scoped to the official `dsh-plugin` topic, star-ranked; every result comes with a ready-to-run `dsh plugin add` command.
fnos-dsh
by fnosp
Multi-source web search and fetch failover for DeepSeek Harness sessions: takes over the session searchProvider and fetchProvider seams and tries configured sources in a chosen order — TinyFish, Tavily and the official search as a fallback that always participates and can be repositioned but not removed. Multiple API keys per platform are spread round-robin, usage snapshots drive pre-flight exclusion of exhausted accounts, and per-request timeouts plus same-platform retry control failover granularity. Web fetching runs local HTTP first, then falls back to TinyFish Fetch server-side rendering and Tavily Extract, so pages still load when local egress is blocked by proxy or DNS policies. A per-platform panel shows key usage and plan limits. Install from npm with `dsh plugin --profile web add @tnnevol/dsh-failover-search`.
modsearch
by liustack
Web/X 搜索与抓取桥:为纯文本 coding agent 提供结构化 JSON 证据(search/fetch/citations),引擎可选 Antigravity CLI(免 key)/带 key 引擎/X(Grok Build 登录态)。
