AI Agent Hub
Back to plugins
dsh-remote-dsh preview

dsh-remote-dsh

Client Updated 2026.09.11

Run the following command in DeepSeek Harness:

dsh plugin install hutao562/dsh-remote-dsh

Paste the following prompt into your AI chat to install this plugin:

Run dsh plugin install hutao562/dsh-remote-dsh in your terminal (source: https://github.com/hutao562/dsh-remote-dsh), then restart DSH once to see the Remote row appear at the top of the sidebar.

About this plugin

Juggling DSH across multiple machines means constantly switching tabs, memorising URLs, and squinting at terminal output. dsh-remote-dsh adds a Remote row at the very top of the DSH sidebar; the moment you click it, the entire page becomes that remote host's DSH Web GUI - top bar, sidebar, session list, all of it belongs to the remote. No extra browser tab, no copying tokens around. A small status capsule at the end of the row keeps an eye on the remote for you: amber means a session is blocked waiting for your approval or reply, blue means something is actively running, green means a session finished a run since you last looked, and red means the peer on that side is not responding.

The status badge is powered by the same plugin running in peer mode on the controlled end. It publishes only anonymous session counts - no IDs, titles, or content - and requires no credentials of its own. Amber is the one state that will not clear just by looking: it is a blocker, not a notification. Open the remote view to see the pending approval or question, answer it, and the dot goes away. Colours and shape are borrowed directly from the remote's own sidebar status dots, so they look familiar rather than like a second, unrelated indicator.

There is one hard rule: the remote DSH must be reachable on a local loopback port (ssh -L, frpc stcp/xtcp + visitor, and the like). The session cookie is HttpOnly with SameSite=Strict, so a cross-site iframe gets an immediate 401. That constraint buys you zero configuration changes on the controlled end and no public domain requirement. Pairing is a one-time paste of the token printed by the remote's dsh web command; the cookie lasts 30 days by default and survives remote restarts, but the token is per-process, so a new process means a fresh pairing.

This plugin is for anyone running DSH on two or more machines who wants to hop between local and remote sessions in a single browser window and get at-a-glance awareness of whether a remote is idle, busy, or waiting on them. There is no build step - lib/ is the source, changes take effect on the fly - making it easy to tweak and extend.

Screenshots

Use Cases

  • Manage DSH sessions on multiple remote machines from a single browser window
  • Spot a pending approval or question instantly via the amber status dot on the sidebar
  • Skip memorising URLs and manual token pasting; pair once and click straight into the remote DSH GUI

Best For

  • Developers running two or more DSH instances who constantly hop between local and remote sessions
  • Operators or platform users who want a single pane of glass for DSH status across hosts
  • Tinkerers who forward ports via FRP or SSH tunnels and prefer not to spin up extra proxies