maxiaovivi/dsh-cloak-browser
CloakBrowser-powered native browser tools with per-agent isolated sessions, bounded snapshots, ref-based interaction, screenshots, and safe routing.
dsh-cloak-browser adds CloakBrowser-powered native browser tools to DeepSeek Harness with per-agent isolated sessions and bounded, structured page state. The README's real end-to-end run opened Wikipedia, discovered the search field from a bounded snapshot, submitted a query, verified the result page, captured a screenshot and closed the browser in ~15 seconds. Browser sessions are isolated per agent; a browser_snapshot-style tool returns a bounded set of stable element refs rather than raw DOM, which keeps anti-automation pages and complex SPAs tractable. Concurrency is handled for free-plan seats (serialized launches, occupancy reporting without retry loops), and a license/proxy environment is read from env vars, never from cordis.patch.yml or tool arguments. First browser use downloads and verifies a ~200MB Chromium archive; no playwright install chromium needed.
Install
dsh plugin --profile web add -w github:maxiaovivi/dsh-cloak-browserGitHub install per README (EN primary with 简体中文): dsh plugin --profile web add -w github:maxiaovivi/dsh-cloak-browser, then restart dsh --profile web. npm 404 verified 2026-09-04 — GitHub is the documented channel. -w is required because a DSH profile is a pnpm workspace root. Requires Node.js 20+, DSH 0.1.0-rc.6, and a platform supported by CloakBrowser. License key optional (CLOAKBROWSER_LICENSE_KEY env): without one CloakBrowser selects its free build; first browser use downloads ~200MB Chromium archive into ~/.cloakbrowser. Proxy optional via CLOAKBROWSER_PROXY_URL.
Compatibility
DeepSeek Harness 0.1.0-rc.6 (per README); Node.js 20+; Linux/macOS/Windows on a CloakBrowser-supported platform; free build works without a license key; ~200MB Chromium cache under ~/.cloakbrowser.
Details
- Repo: maxiaovivi/dsh-cloak-browser
- Category: Tools & Capabilities
- Stars: 0
- Version: git github:maxiaovivi/dsh-cloak-browser (v0.1.1+ reuse the profile's existing dsh-tools/dsh-llm runtimes)
- Last push: 2026-08-16
- First seen: 2026-08-14
Recent updates
No npm release (404 verified 2026-09-04); README documents v0.1.0 → v0.1.1+ duplicate-runtime fix (reuse existing dsh-tools/dsh-llm instances).
FAQ
- Do I need a CloakBrowser license?
- No — without a license key CloakBrowser selects its available free build; export CLOAKBROWSER_LICENSE_KEY only if you have a paid plan. First browser use downloads ~200MB Chromium into ~/.cloakbrowser.
- Why the -w flag on install?
- A DSH profile is a pnpm workspace root, so the GitHub install must run with -w; v0.1.1+ also reuses the profile's existing dsh-tools and dsh-llm runtimes to avoid the duplicate-runtime error.
- Where do credentials go?
- In the environment that starts DSH (CLOAKBROWSER_LICENSE_KEY, CLOAKBROWSER_PROXY_URL) — never in cordis.patch.yml or tool arguments.
Alternatives
MostlyHarmlessxyz/dsh-safe-web-fetch · Clizo1209/dsh-playwright-browser