dsh-remote

DSH Remote

Continue your DSH work from a phone or another computer: read sessions, answer approvals and questions, transfer files, and inspect the host.

English · 简体中文

DSH Remote consists of a DSH plugin, a single-file gateway, and clients. The plugin adds the DSH entry point and manages the gateway. The gateway handles authentication, HTTP/realtime proxying, and files. Clients include Android, mobile/desktop WebUI, and the HarmonyOS source project.

Documentation · Installation · Troubleshooting · Downloads · Issues

For task-based instructions and AI-assisted diagnosis, use the operation and troubleshooting knowledge base (Chinese) or the AI reading index. The plugin includes the same knowledge base as offline Doctor references.

The detailed guides are currently in Chinese. This page and the plugin README provide an English overview and installation path.

The current source is 0.8.0-rc.9 (2026-10-22), a candidate for validation before the stable release. See the rc.9 notes for scope and evidence; a local candidate does not establish npm or GitHub release availability.

Capabilities

Area	Features
Sessions	History and realtime messages, model/reasoning selection, approvals, questions, goals, queues, subagents and turn branches
Learning and diagnosis	Eight-step mobile guide, read-only AI diagnosis, local operation logs and feedback
Files and images	Host browsing, previews, downloads, resumable chunks and image attachments
Host status	Gateway/DSH status, mux/host channels, devices, tokens and cost estimates
Plugins	Installed/discovered plugins, details, configuration toggles and operation records
Session insights	Optional dsh-context summaries and dsh-cost-meter costs/quotas
Weak networks and recovery	Independent long polling, WS backoff, local history, gzip/ETag and bounded crash recovery
Connections and themes	Multiple pairing addresses, groups, LAN/Tailscale and six Web themes; Blue Fat Fish is the default

Mobile navigation is Sessions, Files, More. The session home shows workspaces, recent sessions and items needing attention. More groups host connections, plugins, receipts and preferences. Desktop uses the same three entry points with a wider conversation layout. See platform differences.

The mobile guide teaches connection, chat, files, branches, diagnosis and feedback. Finishing or skipping the entire guide removes its home invitation; reopen it at More → Preferences and maintenance → Getting started. Blue Fat Fish applies when no valid theme is saved; existing selections are preserved.

Image understanding depends on DSH and the model. Cost estimates do not replace provider bills. Insights require the corresponding host plugins and display unavailable states when data is missing. DSH UI renders a safe read-only subset.

Quick start: DSH Web plugin

Confirm that DSH Web works, then run as the same user:

dsh plugin --profile web add @hyprnos/dsh-remote-plugin@latest
dsh plugin --profile web list --depth 0

1. Fully restart DSH Web, hard-refresh with Ctrl+F5, and use the left navigation's More → 手机连接（DSH Remote） to open pairing in a browser. A first-use card explains where to find it; older hosts keep a bottom-left connection button.
2. Confirm the gateway is running and open http://127.0.0.1:8787/health on the host.
3. Generate a connection QR in the plugin wizard or admin console and scan it in More → Hosts and connections → Scan to connect. The APK download QR only installs the app.
4. For manual pairing, use http://PC-LAN-IP:8787 and the token. A phone's localhost refers to the phone.

The example targets the web profile; use your actual profile name. DSH Desktop uses its own plugin manager and requires a complete exit/reopen. Installing into Web does not install into Desktop. For a published candidate, use its exact @<version>; check npm before relying on @next or @latest.

For standalone gateways, multiple addresses, pinned versions and Git-source installation, see the installation guide. A standalone executable can run with --supervise; defaults are 0.0.0.0:8787 and upstream http://127.0.0.1:3080.

Pairing QR codes contain credentials. Use a trusted LAN or Tailscale; keep tokens private and avoid directly exposing the gateway to the public Internet.

Screenshots

Captured on 2026-10-22: rc.9 mobile WebUI with an isolated test host and sample data, showing the default fish skin and the updated More page. These are browser captures, not Android device captures. Older emulator, desktop and admin images remain in the screenshot archive with provenance.

Downloads and platform status

Releases lists versions; Latest is the stable entry point. RCs are separate validation releases.

Platform	Distribution
Android	dsh-remote.apk, Capacitor shell; permissions and device behavior need device validation
Windows x64	dsh-remote-win-x64.exe, no separate Node installation
Linux x64	dsh-remote-linux-x64, grant executable permission
Browser	Connect to the gateway for mobile/desktop WebUI
HarmonyOS	ArkTS/ArkUI source; build and sign yourself; current release CI does not build HAPs
macOS Apple Silicon	CI is configured to build dsh-remote-macos-arm64, ad-hoc sign it and run an isolated startup smoke check; no Apple notarization. Intel uses the plugin or source; see installation

Documentation describes repository 0.8.0-rc.9 on 2026-10-22. HarmonyOS still declares 0.6.26. Check actual release attachments separately from build configuration; this page does not claim that public distribution or all device acceptance checks are complete.

Windows Desktop start/restart is experimental and requires a verified instance and trusted launch configuration. The gateway must stay online. An optional Windows login-start task for the gateway is available in the admin page and is off by default; it does not install a system service. See configuration and limits.

Documentation and development

Ordinary development and pull requests target dev; main is the release branch and remains the GitHub default. See Contributing, Code of conduct, Security policy, and Support.

Documentation index links installation, usage, configuration, troubleshooting, plugin management, session insights, development, modules, compatibility, release, and historical records.

The gateway has no runtime dependencies; the WebUI is plain JavaScript without a build step. The repository retains existing Capacitor/AndroidX and vendored browser assets. Add no new dependencies and follow AGENTS.md. Edit root sources, then sync the plugin.

npm ci
npm run sync-plugin
npm run check
git diff --check

npm run build-app builds Android; npm run publish prepares local APK/update files and does not publish npm. npm run release <version> stages all non-ignored changes, commits, pushes and updates the tag; it requires the release scope to be accepted. Its --dry-run still writes local version files.

Contributors and thanks

The offline credits list includes Blank-not-black, wikkd, anupamme, and liuchang-t. See GitHub Contributors for the full history. This list is not a newly queried contribution ranking.

License

MIT