
huey1in/reef
65Last commit Aug 15, 2026
reef DSH plugin
dsh-reef is a DSH plugin bundle that provides five modules: a native panel injected into the DSH interface, a Playwright-based browser automation suite with 21 tools, an MCP server exposing DSH sessions and agents, GitHub integration with read-only tools and webhook auto-review, and GitLab integration with read-only tools and webhook auto-review. It requires no external runtime packages beyond playwright-core.
How to install the reef DSH plugin
dsh plugin --profile web add dsh-reefCopying does not run this command. Review the repository and version before installing the reef DSH plugin.
reef DSH plugin data source
reef DSH plugin snapshot date: Aug 16, 2026
discovered
What the reef DSH plugin can do
- Browser automation with 21 tools including multi-tab, profile management, download/upload, cookie handling, form replay, and real-time screenshot
- MCP Server exposing DSH sessions and agents via Streamable HTTP with optional OAuth 2.0 authentication
- GitHub read-only tools (repo info, issues, PRs) + webhook auto PR review and issue auto-fix cycle
- GitLab read-only tools (project info, issues, MRs) + webhook auto MR review
- Native embedded panel showing browser status, real-time view, GitHub event board, and per-module settings
Where the reef DSH plugin fits
- Let an AI agent control a real browser to fill forms, navigate pages, and extract data
- Expose DSH as an MCP server so any MCP client can list sessions, run agents, or search history
- Automatically review GitHub PRs or GitLab MRs when they are opened or updated
- Automatically create a fix branch and PR for new GitHub issues tagged with specific labels
- Monitor webhook events and browser state via the native panel without leaving DSH
Who the reef DSH plugin is for
- DSH users who want AI-driven browser automation
- Developers integrating DSH with MCP-compatible tools
- Teams that need automated code review on GitHub or GitLab
reef DSH plugin limitations
- Requires a locally installed Chromium-based browser (Edge/Chrome) via playwright-core; no bundled browser
- Write operations (e.g., creating issues, PRs) are not provided as tools and must be done via `gh`/`glab` CLI or curl
- GitHub and GitLab read-only tools have rate limits unless a token is configured (60 req/hr for anonymous GitHub)
- Windows PowerShell may mangle Chinese JSON when using curl; workaround documented
- Webhook auto-review deduplication only works per commit hash; same PR with different commits will be re-reviewed
reef DSH plugin: from the repository README
Quoted from the huey1in/reef README, the upstream source of the reef DSH plugin. Copyright remains with the original authors.
DeepSeek Harness 全家桶:浏览器自动化 · MCP Server · GitHub/GitLab 集成 · 原生嵌入面板 </p> <p align="center"> <a href="https://github.com/huey1in/reef"><img src="https://img.shields.io/github/stars/huey1in/reef" alt="GitHub stars"></a> <a href="https://github.com/huey1in/reef/actions/workflows/ci.yml"><img src="https://img.shields.io/github/actions/workflow/status/huey1in/reef/ci.yml?label=CI" alt="CI"></a> </p> --- dsh-reef 是一个 DSH 插件 bundle,一次安装提供五个模块: | 模块 | 做什么 | 入口 | | --- | --- | --- | | 🐋 **原生面板** | 注入 DSH 界面右下角:模块状态、浏览器实时画面、GitHub 事件看板、五模块设置区 | 自动注入,无需配置 | | 🧭 **浏览器自动化** | 共享 Playwright 浏览器:多标签、多 profile、下载/上传、Cookie、表单回放,21 个 `browser_*` 工具 | `browser_*` 工具 | | 🔌 **MCP Server** | 把 DSH 的会话与 agent 反向暴露给任何 MCP 客户端(Streamable HTTP + OAuth) | `http://127.0.0.1:3080/reef/mcp` | | 🐙 **GitHub 集成** | 4 个只读工具 + webhook 自动 PR 评审 + issue 自动修复闭环 + 事件看板 | `github_*` 工具 + webhook | | 🦊 **GitLab 集成** | 3 个只读工具 + webhook 自动 MR 评审 | `gitlab_*` 工具 + webhook | 设计原则:**能做的一次性操作交给 agent 用 bash 完成(如 GitHub 写操作配 `gh` CLI),插件只做 bash 做不到的常驻自动化与集成**。唯一第三方运行时依赖是 `playwright-core`(复用系统已装的 Edge/Chrome,无需下载 Chromium),不依赖任何 `@deepseek-ai` 运行时包。 --- ## 安装 ```sh dsh plugin --profile web add dsh-reef ``` 重
Read the full READMERepository license: MIT
reef DSH plugin questions
How do I install dsh-reef?
Run `dsh plugin --profile web add dsh-reef` in your terminal, then restart DSH. The plugin will be automatically loaded. If you want to disable a specific module, remove its line from `$DSH_HOME/profiles/web/cordis.patch.yml` or set `enabled: false`.
Does dsh-reef require a separate browser?
It requires a Chromium-based browser (like Edge or Chrome) already installed on your system. The plugin uses playwright-core to connect to it. If you don't have one, install Chromium via `npx playwright install chromium` or set the `executablePath` in config.
Can I use dsh-reef to write issues or PRs on GitHub?
The plugin only provides read-only tools for GitHub and GitLab. For write operations, you should use the `gh` CLI, `glab` CLI, or `curl` with a token. This is by design because write operations are better handled by the DSH agent's bash capability.
How do I configure the webhook for automatic PR review?
In your GitHub repository settings, add a webhook URL `http://<your-machine>:3080/reef/github/webhook` with Content type `application/json`, set a secret matching `GITHUB_WEBHOOK_SECRET`, and select the Pull requests event. The plugin will then automatically review new/updated PRs.
What authentication does the MCP server support?
The MCP server supports three methods: static Bearer token (set in the panel or via `authTokenEnv`), environment variable reference, and OAuth 2.0 client_credentials flow. You can enable multiple methods simultaneously.