Back to directory

dsh-remote

In a curated listMaintenance: Active

hyna-hla/dsh-remote

Pair a mobile client with DSH for remote sessions, approvals, MCP/file browsing, and token-gated host access.

View on GitHub
$ dsh plugin add dsh-remote

22

stars

3

forks

Kotlin

Language

MIT

License

2026-08-14

Created

2026-08-31

Last push

MIT-licensed, unofficial Kotlin Android client for DeepSeek Harness: remote sessions, approvals, notifications, themes and token-gated host access.

DSH integration

Compatible

Author-claimed

Safety audit

Unaudited

Last verified

2026-11-10

License

MIT

01What can it help you accomplish?

  • Dispatch tasks to the DeepSeek Harness agent running on your computer from your phone

    A mobile client with a live chat stream — messages, streaming output, Markdown and tool-call cards with arguments and results

    DSH users who want to keep a session going while away from the desk

  • Approve or reject tool calls and answer the agent's questions from the lock screen

    High-priority notification banners for approvals and questions, plus a completion reminder when a run goes from running to idle

    Users who do not want to keep the app open to catch an approval request

  • Reach the PC's DSH over the LAN or through your own tunnel, without exposing it to strangers

    A connection that requires a 6-digit pairing code, after which every API and realtime request carries a channel token

    Users who need remote access but do not want an open port to be usable by anyone who finds the address

02How to install into DeepSeek Harness

Prerequisites

  • An Android phone and a PC running the DSH service you want to reach
  • For public access: any self-hosted tunnel (cpolar / cloudflared / ZeroTier or your own) — v2.0.0 dropped the built-in WeChat remote and cpolar tunnel
  • For building from source: JDK 17 + Android SDK (platform 36) + Gradle 8.14.3

Installation steps

  1. 01

    Download the APK from Releases (the debug main package), or update in-app — the app checks GitHub Releases at most once a day

  2. 02

    Transfer it to the phone, allow installs from unknown sources, then enter the server address

  3. 03

    LAN mode: fill in the PC's LAN address such as http://192.168.1.100:8787; public mode: map the DSH port to a public domain with your own tunnel and use that address

  4. 04

    On the PC, confirm the pairing under Settings → Remote control (or generate a pairing code there and type the 6-digit code in the app)

Verify the integration

Not specified by the author

03DSH integration and capability boundaries

DSH integrationCompatible

An unofficial third-party Android client that talks to a running DSH service on your PC through its HTTP and WebSocket API, plus a companion PC-side DSH plugin (dsh-remote-access) that handles pairing and channel tokens.

  • Live session stream

    the connected DSH service's API and event channel→messages, streamed output, Markdown rendering and tool-call cards with arguments and results

  • Approvals, questions and notifications

    approval and question events from the DSH service→allow-once / reject decisions and single- or multi-choice answers, delivered from notification banners

    a foreground service keeps the notification channel alive
  • Session and model controls

    the app's session view and settings→recent session list, paged history, archive/restore, stop a run, steer messages into a thinking run, model and reasoning effort switching

  • Theming

    the built-in themes or an imported theme package (zip with theme.json plus an optional preview image, or a single theme.json)→five built-in themes plus imported ones, with UI / code font switching

04Who is it for? When not to use it?

Good for

  • DSH users who want to keep a session going while away from the desk
  • Users who do not want to keep the app open to catch an approval request
  • Users who need remote access but do not want an open port to be usable by anyone who finds the address

Not for

  • When connecting through a public tunnel, the tunnel's public domain must be added to Settings → Remote control → public domain allowlist (written into the DSH core's client-connection.trustedHosts), otherwise the core's Host fence returns 403.
  • Approvals only support allow-once / reject, matching the web client; if the server's approval policy is never, no approval request appears at all.

05Compatibility, maintenance and safety notes

  • This is a personal third-party community client built on DeepSeek Harness, not an official DeepSeek product; the README asks you to refuse any offer to sell it.
  • When connecting through a public tunnel, the tunnel's public domain must be added to Settings → Remote control → public domain allowlist (written into the DSH core's client-connection.trustedHosts), otherwise the core's Host fence returns 403.
  • Approvals only support allow-once / reject, matching the web client; if the server's approval policy is never, no approval request appears at all.
  • The session view loads the last 3 messages first, then 15 per page, then the whole history; loading a very large session depends on network speed. Image messages only support the content types DSH's protocol core accepts (PNG / JPEG / WebP / GIF), and long images are sampled rather than scaled.
2026-08-142026-08-31v2.5.1

MIT · unofficial third-party client · latest release v2.5.1 (2026-08-18); README states it is not an official DeepSeek product

06Frequently asked questions

Is dsh-remote an official DeepSeek app?

No. The README states it is a personally developed community third-party client built on DeepSeek Harness, not an official DeepSeek product, and asks you to refuse anyone who tries to sell it to you.

How do I connect the app to my PC?

On the same Wi-Fi, enter the PC's LAN address such as http://192.168.1.100:8787. For public access, map the DSH port to a public domain with your own tunnel and enter that. The first connection has to be confirmed on the PC under Settings → Remote control.

Why do I get a 403 through my tunnel?

The tunnel's public domain has to be added to Settings → Remote control → public domain allowlist, which writes into the DSH core's client-connection.trustedHosts and takes effect after a restart; otherwise the core's Host fence rejects the request with 403.

Can anyone with the address control my DSH?

No. After pairing, a remote channel token is issued to the app and every API and realtime request requires it, so someone who only has the address cannot control your DSH.

Does it still bundle a tunnel or WeChat remote control?

No. Since v2.0.0 the built-in WeChat remote control and the cpolar tunnel were removed, along with the tunnel helper scripts; use any tunnel of your own — channel authentication applies to all of them.

08Data and sources

  • Author-claimedgithub.com3ae5f26e5df9…

    dsh-remote — 第三方 DeepSeek Harness 手机遥控端

  • Author-claimedgithub.com3ae5f26e5df9…

    把 DeepSeek Harness 装进口袋:手机 App 连接你电脑上正在运行的 DSH 服务, 随时随地给智能体派任务、看进展、批审批。

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.