dsh-ssh-terminal

dsh-ssh-terminal

🌏 English · 中文

An SSH terminal tab for dsh-better-sidebar: connect to a remote host and watch the agent's commands and output step by step, without touching the main conversation. Also ships SSH tools for the agent.

Features

• better-sidebar "SSH 终端" tab: appears in the sidebar + menu. Opens a panel with a connection form, a command input, and a live command→output transcript (timestamps, theme-aware colors).
• Concurrent connections: every ssh_connect creates an isolated SSH process, output buffer, and command queue. The sidebar lists all connections and switches to the selected transcript.
• Agent tools (standalone): ssh_connect / ssh_exec / ssh_disconnect / ssh_status / ssh_list.
• Local history persistence: the record survives restarts on this machine (saved to ~/.dsh/ssh-terminal-history.json); the "清空当前" button clears only the selected connection's history.

Multi-task usage

Parallel tasks must keep the connectionId returned by ssh_connect and pass it to subsequent ssh_exec, ssh_status, and ssh_disconnect calls. Different connection IDs can run concurrently; commands on one connection are queued in order so they cannot interleave writes to the same SSH PTY. Calls without an ID remain compatible with the current active connection.

Dependencies

• DSH web (dsh web / DSH Desktop)
• dsh-better-sidebar (>= 0.12.0) — only needed for the sidebar panel; the agent SSH tools work standalone.

Optional: without better-sidebar, this plugin only exposes the agent SSH tools (the model can connect, run commands, disconnect, and see results in the conversation); the sidebar "SSH 终端" panel is not shown.

Install

dsh plugin add github:sunzhyang1616-ui/dsh-ssh-terminal

After installing, hard-refresh the browser (Cmd/Ctrl+Shift+R). Client changes hot-load; only Host changes need a DSH restart.

Local install (source / link)

1. Let a profile use this package: add to ~/.dsh/profiles/<profile>/package.json dependencies
   "dsh-ssh-terminal": "link:<absolute path to this dir>"
2. The bundle patch is declared by package.json ("dsh": { "bundle": { "patch": "./cordis.patch.yml" } })
3. Run pnpm install in the profile dir
4. Hard-refresh the browser (Cmd/Ctrl+Shift+R)

Files

Limitations / Notes

• The SSH connection is Host-process state; it drops on DSH restart (no auto-reconnect). The operation record is persisted locally and survives restarts.
• Passwords are used only for that call and are never echoed or written to the transcript; prefer identity (private key file) auth.
• The Host half uses ctx.tools.register + a webServer route (no harness), so it works for installed plugins.