MIT-licensed DSH plugin (JavaScript) for remote access: host-side PWA plus pairing gateway with Web Push, and a desktop client pooling up to 8 hosts.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-11-10
License
MIT
01What can it help you accomplish?
Reach your DSH sessions from a phone as an installable PWA
A mobile UI with a session list home, a session page with swipe-back, a compact composer with bottom sheets and a session info card
DSH users who want to check progress or send a follow-up from a phone
Pull the sessions of several machines into one DSH desktop sidebar
Up to 8 paired hosts as extra sidebar groups, with full history, live streaming, approvals, per-host model catalogs, file tree, Git diffs and a server-side terminal
Developers running DSH on more than one machine
Get a lock-screen notification only when the agent really needs you
Encrypted Web Push for tool approvals and ask_user_question, plus an optional model-triggered push_notify tool
Users who leave a long run unattended
02How to install into DeepSeek Harness
Prerequisites
- DSH desktop app or a headless `dsh web` server; the desktop app's `desktop` profile is managed exclusively by the app, so `--profile desktop` is refused on the CLI
- For public access: a domain on Cloudflare (Managed Caddy or Cloudflare Tunnel), an existing reverse proxy, or LAN / Tailscale reachability
Installation steps
- 01
UI install: open Plugins in the DSH sidebar → Add plugin → type `dsh-zen-remote` → Enable now when the install finishes → restart the app (or `dsh web`)
$ dsh web
- 02
CLI install on a headless server: `dsh plugin --profile web add dsh-zen-remote`, then restart `dsh web`
$ dsh plugin --profile web add dsh-zen-remote
- 03
Run the bundled wizard to pick a role, configure ingress and pair devices: `npx dsh-zen-remote setup`
$ npx dsh-zen-remote setup
- 04
Pair a phone by generating a QR on the Pair Phone / Browser tab, scanning it, and entering the 8-character code; pair another desktop from the Pair Desktop Client tab
Verify the integration
- `dsh-zen-remote status` prints the current role, gateway and connection state (add `--json` or `--debug` for machine-readable or redacted diagnostics)
- Wizard step 3 shows three status lights — pairing token, server connection, session & plugin sync — that must all turn green
Rollback
- Click Uninstall on the dsh-zen-remote plugin page and restart; to also wipe pairing and share state, delete `~/.dsh/lan-gate-state.json`, `~/.dsh/lan-gate.config.json` and `~/.dsh/zen-remote-state.json`
03DSH integration and capability boundaries
A DSH bundle with two roles: `host` runs the session, a local security gateway and Web Push, and serves a phone PWA; `client` runs inside another DSH desktop app and mounts up to 8 hosts' shared sessions into its own sidebar.
Ingress setup wizard and headless CLI
the role choice and one of four access methods — Managed Caddy, existing reverse proxy, Cloudflare Tunnel, or LAN / Tailscale direct→a running gateway on 127.0.0.1:3088 or 0.0.0.0:3088, TLS via DNS-01 for Caddy, or ready-to-paste proxy snippets
the plugin downloads and manages Caddy or cloudflared processesCloudflare tokens live in 0600 files under ~/.dsh/zen-remote-ingress/Session sharing and idle sleep
per-session remote-access toggles from the host sidebar, session header, phone info card or settings page→shared sessions visible to paired devices; remote access closes after 48 hours of inactivity by default
closed or unpaired sessions are archived or hidden from the client sidebarWeb Push notifications
tool-approval requests, ask_user_question waits, or the model-callable push_notify tool→end-to-end encrypted (aes128gcm) lock-screen notifications
pushEnabled off stops every automatic push and unregisters push_notifyPlugin bridge for cooperative plugins
panel HTTP and WebSocket requests from plugins such as dsh-better-sidebar (0.25.0–0.30.1)→those panel requests routed to the host machine in remote sessions
whole-machine data access requires explicit owner consent per plugin
04Who is it for? When not to use it?
Good for
- DSH users who want to check progress or send a follow-up from a phone
- Developers running DSH on more than one machine
- Users who leave a long run unattended
Not for
- Both ends must run the same dsh-zen-remote version; DSH host versions may differ because interface fingerprints are compared at handshake.
- A paired desktop client runs terminals and file previews as the host's OS user; unshared sessions are filtered and refused at the relay layer, and even when binding 0.0.0.0 the gateway rejects unproxied public IPs.
- DSH's own Settings RPCs are loopback-only by upstream design, so plugin settings must be edited on the machine running DSH, not through a remote browser.
05Compatibility, maintenance and safety notes
- Both ends must run the same dsh-zen-remote version; DSH host versions may differ because interface fingerprints are compared at handshake.
- A paired desktop client runs terminals and file previews as the host's OS user; unshared sessions are filtered and refused at the relay layer, and even when binding 0.0.0.0 the gateway rejects unproxied public IPs.
- DSH's own Settings RPCs are loopback-only by upstream design, so plugin settings must be edited on the machine running DSH, not through a remote browser.
- With HMR on, remove dsh-zen-remote first and then install the new version; DSH 0.2.1-alpha.3+ profile resets replace a custom profile, so back up ~/.dsh/profiles/<name> first.
- iOS 26.x home-screen PWAs may lose a status-bar height at the bottom because of an iOS WebKit bug; three mitigation layers are built in and restarting the PWA restores full height.
MIT per the repository LICENSE · latest release v2.4.1 (2026-11-09); npm package with provenance signing; the plugin reports nothing to any third party
06Frequently asked questions
How do I install dsh-zen-remote?
In the DSH sidebar open Plugins → Add plugin, type `dsh-zen-remote`, click Enable now when it finishes, then restart the app. On a headless server run `dsh plugin --profile web add dsh-zen-remote` and restart `dsh web`.
What does `npx dsh-zen-remote setup` do?
It runs a 3-step interactive wizard — role, ingress, then verify with a terminal QR code and desktop pairing — so a headless VPS can finish setup, ingress configuration, the three-light verification and pairing without opening a browser.
Can a paired desktop client do anything on my machine?
Yes, within what you share: a paired desktop client runs terminals and file previews as the host's OS user, while unshared sessions are strictly filtered and refused at the relay layer.
How many hosts can one client connect to?
Up to 8 main servers, connected in pairing order; when all 8 slots are full a red limit notice appears and re-pairing an existing URL overwrites in place.
Why can't I edit plugin settings from my phone?
DSH's own Settings RPCs are loopback-only by upstream design, so plugin settings have to be edited on the machine running DSH rather than through a remote browser.
07Related DSH workflows
open-design
by nexu-io
The 1st Collaborative AI Design Agent Workspace. Local-first and open source. Create motion, prototypes, websites, apps, dashboards, presentations, images, and videos with your team and AI agents. Share work, exchange feedback, and iterate together in one workspace.
mole
by tw93
🐹 Open-source Mac and PC cleaner. Keep your machine clean, light, and running like new. Fast CLI, plus native Mac and Windows apps.
dsh-desktop
by anywhere-labs
Modern desktop client for the DeepSeek Harness (dsh) plugin ecosystem. Everything is a plugin — even the desktop shell itself.
picgo
by molunerfinn
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosting services (S3, GitHub, Cloudflare R2, Imgur, Aliyun OSS...). Paste, upload, done.
08Data and sources
One DeepSeek Harness plugin, two roles. The <b>host</b> turns DSH into a phone-reachable PWA (mobile UI, pairing gateway…
Open the **Plugins** page in the DSH sidebar → click **Add plugin** → type `dsh-zen-remote` → click **Enable now** when…
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-10. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.
