Back to directory

dsh-zen-remote

In a curated listMaintenance: Active

kyomio/dsh-zen-remote

Reach DSH sessions from a phone or another desktop through pairing-code access, a PWA and Web Push.

View on GitHubHomepage
$ dsh web

28

stars

9

forks

JavaScript

Language

NOASSERTION

License

2026-08-17

Created

2026-11-13

Last push

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

  1. 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

  2. 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

  3. 03

    Run the bundled wizard to pick a role, configure ingress and pair devices: `npx dsh-zen-remote setup`

    $ npx dsh-zen-remote setup

  4. 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

DSH integrationNative runtime

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 sidebar
  • Web 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_notify
  • Plugin 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.
2026-08-172026-11-08v2.4.1

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.

08Data and sources

  • Author-claimedgithub.coma097622d8afd…

    One DeepSeek Harness plugin, two roles. The <b>host</b> turns DSH into a phone-reachable PWA (mobile UI, pairing gateway…

  • Author-claimedgithub.coma097622d8afd…

    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.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.