titanwings/dsh-better-browser
80Last commit Aug 13, 2026
dsh-better-browser DSH plugin
dsh-better-browser connects to Kimi WebBridge's local daemon, allowing DSH agents to use the user's already-logged-in browser. It provides 13 tools for navigation, clicking, filling, screenshots, and network inspection, while keeping browser state local.
How to install the dsh-better-browser DSH plugin
dsh plugin --profile web add github:titanwings/dsh-better-browser#v0.3.6Copying does not run this command. Review the repository and version before installing the dsh-better-browser DSH plugin.
dsh-better-browser DSH plugin data source
dsh-better-browser DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-better-browser DSH plugin can do
- Navigate to any URL and set a tab group for the task session.
- Read accessibility tree snapshots for element references.
- Click elements by @e reference or CSS selector.
- Fill input fields, textareas, or contenteditable elements.
- Execute synchronous or asynchronous JavaScript in the page.
- Take screenshots of the page or specific elements.
- List tabs in the current session.
- Start/stop and inspect network activity.
- Upload files from the agent's workspace via file input.
- Save the current page as PDF.
- Close the current tab or all tabs in the session.
Where the dsh-better-browser DSH plugin fits
- Automate tasks on websites that require an existing login session, like checking issues on GitHub.
- Perform multi-step workflows (navigate → snapshot → click → fill → screenshot) without copying cookies.
- Inspect network requests and page elements while keeping the browser state intact.
- Let agents upload files to a web form using the real browser's file picker.
Who the dsh-better-browser DSH plugin is for
- Users who want their DSH agents to interact with web services that require prior authentication.
- Developers building browser-based automation flows that reuse existing browser tabs and sessions.
dsh-better-browser DSH plugin limitations
- Sites that strictly check `event.isTrusted` may ignore synthetic click/fill events.
- Snapshot, click, fill, and evaluate only work on the top-level frame, not cross-origin iframes.
- Screenshot returns a temporary file path that requires a Read tool to view.
- Tab groups are managed by the daemon; restarting the daemon clears them.
- Requires Kimi WebBridge daemon and browser extension to be installed and running.
dsh-better-browser DSH plugin: from the repository README
Quoted from the titanwings/dsh-better-browser README, the upstream source of the dsh-better-browser DSH plugin. Copyright remains with the original authors.
### *让 Agent 使用你已经登录的真实浏览器。* [](https://github.com/deepseek-ai) [](package.json) [](package.json) [](LICENSE) [](https://github.com/titanwings/dsh-better-browser/stargazers) <br> <table> <tr><td align="left"> 🔐 需要 Agent 操作已经登录的网站，又不想复制 Cookie 或重新登录？<br> 🧭 需要导航、点击、填写、截图和网络检查组成一条完整工作流？<br> 🧠 希望浏览器状态留在本机，而不是不断塞进模型上下文？ </td></tr> </table> ### ✨ dsh-better-browser 把用户真实浏览器变成 13 个 Agent 工具。 通过本机 Kimi WebBridge 复用登录态、已有标签页和活动会话；DSH 负责模型工具， 浏览器状态继续留在浏览器里。 **真实浏览器 + 本地桥接 + 13 个工具 → Agent 可执行的完整浏览器工作流** <br> [为什么需要它](#why) · [核心能力](#features) · [安装](#install) · [快速开始](#quick-start) · [工具](#tools) · [安全边界](#safety) [English](README.en.md) · **简体中文** <br>  </div> --- <a id="why"></a> ## 🎯 为什么需要 dsh-better-browser 无头浏览器适合隔离测试，却无法
Read the full READMERepository license: BSD-3-Clause
dsh-better-browser DSH plugin questions
How do I install dsh-better-browser?
First install Kimi WebBridge daemon and browser extension from the official site. Then run `dsh plugin --profile web add github:titanwings/dsh-better-browser#v0.3.6` and restart `dsh web`. The plugin will register the tools automatically.
Does the plugin work with any browser?
It only works with browsers that have the Kimi WebBridge extension installed (Chrome or Edge). The plugin communicates with the local daemon, which in turn controls the browser via the extension.
Can I use this plugin without Kimi WebBridge?
No. The plugin is a bridge to the Kimi WebBridge daemon; it does not include any browser automation code. You must install and run the daemon and extension separately.
How do I update the plugin from an older version?
If you had the old package `@dsh-external/dsh-better-browser`, remove it first with `dsh plugin --profile web remove @dsh-external/dsh-better-browser`, then add the new one as shown in the install section.
Will the agent close my browser tabs?
No. Tabs are only closed when you explicitly request it via the `close_tab` or `close_session` tools. The agent will not clean up tabs after a task ends.