Blank-not-black/dsh-Remote
30Last commit Aug 16, 2026
dsh-Remote DSH plugin
DSH Remote is a DSH plugin that includes a built-in gateway and an Android app (Capacitor hybrid, not PWA). It lets you remotely manage DSH sessions, approve tool calls, ask questions, and transfer files up to 2GB with resume support and SHA-256 integrity checks. The gateway auto-starts with DSH and provides a token-based management panel accessible from the browser or the mobile app.
How to install the dsh-Remote DSH plugin
dsh plugin --profile web add dsh-remote-pluginCopying does not run this command. Review the repository and version before installing the dsh-Remote DSH plugin.
dsh-Remote DSH plugin data source
dsh-Remote DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-Remote DSH plugin can do
- Remote session management: view, create, and interact with DSH sessions from the Android app
- File transfer up to 2GB with chunked upload, resume, pause/cancel, and SHA-256 integrity verification
- Multi-server automatic switching: add multiple addresses (LAN/Tailscale) and the app auto-selects the fastest
- Offline caching: session list and history remain viewable even when the gateway is disconnected
- Token-based authentication with QR code pairing for quick setup
- Gateway self-healing: auto-restarts if crashed, and can be manually stopped/started from the drawer
Where the dsh-Remote DSH plugin fits
- Approve DSH tool calls from your phone while away from the desk
- Transfer photos or files from your phone directly to the server via the app
- Monitor and control DSH sessions on the go over LAN or Tailscale
- Check session history and goals offline when the gateway is temporarily unreachable
Who the dsh-Remote DSH plugin is for
- DSH users who want to manage their assistant remotely from an Android phone
- Power users who need to transfer large files between their phone and server with resume and integrity checks
- Users who frequently need to approve or reject tool calls away from their main computer
dsh-Remote DSH plugin limitations
- Android app only (no iOS version); phone browser can also access the gateway but has limited functionality
- Requires DSH (web profile) to be running; the gateway depends on DSH Web process
- Token security: anyone with the token can control the DSH, so it must be kept secret
- File transfer root is limited to configured directories (default ~); path traversal and symlink escapes are blocked
dsh-Remote DSH plugin: from the repository README
Quoted from the Blank-not-black/dsh-Remote README, the upstream source of the dsh-Remote DSH plugin. Copyright remains with the original authors.
> **口袋里的 DSH 控制台** —— 手机远程会话 · 审批 · 提问 · 文件互传，局域网 / Tailscale 都能用 **中文** · [English](README.en.md) [](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin) [](https://www.npmjs.com/package/dsh-remote-plugin) [](https://github.com/Blank-not-black/dsh-Remote/releases/latest) [](https://github.com/Blank-not-black/dsh-Remote) [](LICENSE) [](#) 躺床上也能批准 DSH 的工具调用、随时查看会话、把手机照片直接传进服务器——**安卓 App（Capacitor 混合应用，含相机原生插件），不是 PWA 网页套壳**。 **插件 + 内置网关 + 手机 App 是一个整体**：装插件时网关随插件分发、随 DSH 自动启停，抽屉里直接拿到令牌和主机地址，手机 App 填上即可远程操控 DSH。 ## ✨ 亮点 | | | | --- | --- | | 📱 **安卓 App（Capacitor）** | 不是 PWA 套壳：会话 / 审批 / 提问 / goal / 文件互传，一个 App 全搞定 | | 🔐 **自愈网关** | 插件内置网关随 DSH 自动启停，挂了自动拉起；Bearer token 鉴权，谁拿 token 谁操控 | | 📦 **2GB 文件互传** | `/fs/*` 直连传输，**断点续传** + 暂停/继续/取消 + **SHA-256
Read the full READMERepository license: MIT
dsh-Remote DSH plugin questions
How do I install DSH Remote?
Run `dsh plugin --profile web add dsh-remote-plugin` in your DSH terminal, then restart DSH Web and hard refresh your browser (Ctrl+F5). You'll see the DSH Remote entry in the left sidebar. Install the Android app from the Releases page to use the full mobile experience.
How do I connect my phone to the gateway?
Open the DSH Remote drawer in your browser sidebar (after installing the plugin). Click the QR code button to generate a pairing QR. In the Android app, go to Settings → Scan QR Code and scan it. The server address and token will be configured automatically. Alternatively, you can manually enter the token and host IP.
Can I transfer files larger than 2GB?
The default upload limit is 2GB. You can increase it by setting the environment variable `DSH_REMOTE_FS_MAX_UPLOAD` to the desired byte value before starting the gateway. Note that the phone app's upload might be limited by device storage and network conditions.
Is the file transfer secure?
Yes, all file transfers are authenticated via Bearer token. The gateway uses SHA-256 integrity checks for uploaded chunks and final files. For remote access over the internet, it's recommended to use Tailscale for an encrypted tunnel. The token should be kept secret as anyone with it can control the DSH.
What if the gateway stops working?
The gateway has a self-healing mechanism: it will automatically restart within seconds if it crashes or if DSH restarts. You can manually stop/start it from the drawer. If the auto-restart is disabled, ensure the environment variable `DSH_REMOTE_AUTOSTART` is not set to 0. Check the token file at `~/.dsh-remote/token` and firewall settings for port 8787.