dsh-zen-remote
In a curated listMaintenance: Activekyomio/dsh-zen-remote
Reach DSH sessions from a phone or another desktop through pairing-code access, a PWA and Web Push.
$ dsh plugin add dsh-zen-remoteInstall
dsh has no central install command — add this plugin’s entry (documented in its README) to your profile or patch config, then restart.
How installs work24
stars
9
forks
JavaScript
Language
NOASSERTION
License
2026-08-17
Created
2026-11-02
Last push
README
dsh-zen-remote
One DeepSeek Harness plugin, two roles. The host turns DSH into a phone-reachable PWA (mobile UI, pairing gateway, lock-screen push) and shares chosen sessions to paired desktops. The client runs inside another DSH desktop app and puts the host's shared sessions right into its own sidebar — full history, live progress, messages, approvals, terminal, everything executes on the host.
| Session list home | Session page | Session info card |
|---|---|---|
![]() |
![]() |
![]() |
| Composer permission sheet | Pairing page a public visitor sees |
|---|---|
![]() |
![]() |
Screenshots are a 390×844 phone viewport in the light theme; both themes are supported. The pairing page is drawn by the gateway in DSH's official style, following the system light / dark appearance.
Contents
- Install
- Quick Start (Unified Setup & Pairing Wizard)
- Daily Usage: Session Sharing & Cross-Device Workflow
- Lock-Screen Push: When Notifications Fire
- Features
- Advanced Settings & Field Reference
- Security Model, Version Tolerance & Known Notes
1. Install
Install from the UI (Recommended, Desktop App & Web UI)
Open the Plugins page in the DSH sidebar → click Add plugin → type dsh-zen-remote → click Enable now when the install finishes, then restart the DSH desktop app (or dsh web).
Install from the CLI (Headless dsh web server)
dsh plugin --profile web add dsh-zen-remote
# then restart dsh web
dsh pluginrequires--profileto name the target profile. The desktop app'sdesktopprofile is managed exclusively by the app (--profile desktopis refused on the CLI), so use the UI install above on the desktop app.
Manual Profile Edit / Local Development (link:), Upgrading & Uninstall
Editing the profile by hand (local development, link: installs): add the dependency to the profile's package.json (~/.dsh/profiles/desktop for the desktop app, ~/.dsh/profiles/web for the web service) and append "dsh-zen-remote" to the dsh.profile.bundles array:
// ~/.dsh/profiles/desktop/package.json
{
"dependencies": {
"dsh-zen-remote": "^2.3.8" // for local development: "link:/path/to/dsh-zen-remote"
}
}
cd ~/.dsh/profiles/desktop && pnpm install
# For a link: checkout, also run `npm install --omit=dev` inside the repository so the gateway subprocess can resolve `web-push`.
Upgrading & migration notes:
- Upgrading with HMR on: remove
dsh-zen-remotefirst, then install the new version (dsh plugin --profile <name> remove dsh-zen-remote→add dsh-zen-remote, or Uninstall → Add in the Plugins page). - DSH 0.2.1-alpha.3+ profile reset:
dsh --profile <name> --from-default-profile <template>replaces an existing custom profile with a fresh copy; back up~/.dsh/profiles/<name>first. - Upgrading from 1.x: since 2.0.0 the composition layer is a single row (
dsh-zen-remote). Remove any legacydsh-zen-remote-gateway,dsh-zen-remote-push, or manualdsh-push.mjslines fromcordis.patch.yml. Existing~/.dsh/lan-gate.config.jsonsettings and paired devices carry over automatically. - Uninstalling: click Uninstall on the
dsh-zen-remoteplugin page and restart. To also wipe pairing and share state, delete~/.dsh/lan-gate-state.json,~/.dsh/lan-gate.config.json,~/.dsh/zen-remote-shares.json, and~/.dsh/zen-remote-server.json.
2. Quick Start (Unified Setup & Pairing Wizard)
More in Desktop & Apps
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.
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.
dsh-desktop
by dataelement
Modern desktop client for the DeepSeek Harness (dsh) plugin ecosystem.





