Back to directory

dsh-ssh-ops

In a curated listMaintenance: Active

caoyiwei850/dsh-ssh-ops

SSH terminal (xterm.js), SFTP file manager, port forwarding, multi-server fan-out, DB query/management over SSH tunnel, 24 agent tools.

View on GitHub
$ dsh plugin --profile web add github:caoyiwei850/dsh-ssh-ops#v0.4.12

60

stars

23

forks

JavaScript

Language

MIT

License

2026-08-15

Created

2026-11-19

Last push

MIT native DSH SSH plugin: live terminal, 41 Agent tools, host approval for risky commands. Passwords and keys only in owner-only `~/.dsh/.credentials.yaml`; server configs support encrypted export/import.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-11-20

License

MIT

01What can it help you accomplish?

  • Operate remote servers from DSH chat while watching a live terminal

    An interactive SSH session in the official right sidebar, with Agent commands echoed on-screen and structured results in the thread

    DevOps and developers who run DeepSeek Harness and need visible SSH/SFTP workflows

  • Run confirmed multi-server commands from saved SSH resources

    A batch task with per-server results after you pick targets in the SSH panel checkbox dialog

    Operators managing fleets who want Agent-initiated fan-out without silent cluster-wide execution

02How to install into DeepSeek Harness

Prerequisites

  • DSH Desktop or Web Profile with `engines.dsh` >= 0.2.0
  • Host must expose `sidebarRightTabs` and `sidebarRight` (new official right sidebar); plugin uses DSH bundled Node.js — no system `ssh`, `sftp`, or standalone Node.js required

Installation steps

  1. 01

    In DSH plugin management, install npm package `dsh-ssh-ops` (recommended). From GitHub instead: `dsh plugin --profile web add github:caoyiwei850/dsh-ssh-ops#v0.4.12`

    $ dsh plugin --profile web add github:caoyiwei850/dsh-ssh-ops#v0.4.12

  2. 02

    Fully quit and restart the DSH profile after install or upgrade (for Web: run `dsh web`)

    $ dsh web

  3. 03

    Open any chat session, click the top **SSH** tab, and connect a server from the right panel

Verify the integration

  • After restart, the **SSH** tab appears in the chat header and the right panel lets you connect to a saved or temporary server

03DSH integration and capability boundaries

DSH integrationNative runtime

Native DSH plugin: registers an official right-sidebar SSH tab plus Agent tools that default to the visible active connection.

  • Official right-sidebar SSH terminal

    Saved SSH resources or ad-hoc connections from Settings → SSH 资源→Interactive PTY terminal tab alongside the DSH files panel, with independent connections per split pane

    Opens SSH sessions to user-chosen hosts; keeps connections alive with keepalive and may auto-reconnect after transport errors
  • SFTP file panel

    Remote paths on the active SSH connection→Browse, upload, download, search and edit remote files with optional streaming progress on supported browsers

    Reads and writes remote files via SFTP; may create backup copies on the server before saves
  • Port forwarding tab

    Local or remote forward targets reachable through the SSH session→Active tunnels listable and stoppable in the panel or via `tunnel_*` Agent tools

    Registers local or remote TCP listeners while tunnels stay open
  • Database panel and `db_*` tools

    MySQL, PostgreSQL, Redis, or MongoDB endpoints, optionally via SSH tunnel→Query tables, run guarded SQL/Redis/Mongo commands, export CSV, and manage saved DB profiles

    Connects to databases over the network (often through SSH); stores saved DB passwords in `~/.dsh/.credentials.yaml`
  • Agent SSH/SFTP/tunnel/DB tool suite

    Natural-language tasks in the main DSH chat (defaults to the active connection)→Up to 41 registered tools (individually disable DB, tunnels, or session-log tools in feature switches)

    May execute shell on remote hosts, mutate remote files, or run SQL when approved; output is redacted for keys and tokens before model context

04Who is it for? When not to use it?

Good for

  • DevOps and developers who run DeepSeek Harness and need visible SSH/SFTP workflows
  • Operators managing fleets who want Agent-initiated fan-out without silent cluster-wide execution

Not for

  • Targets DSH Desktop / Web with `engines.dsh` >= 0.2.0; without `sidebarRightTabs` and `sidebarRight` the Agent tools still run but the terminal UI does not appear.
  • High-impact Agent commands (destructive shell, `sftp_delete`, dangerous SQL) suspend until the host approval UI accepts or rejects; absent approval channel means fail-closed rejection.
  • Server metadata lives in DSH local storage; passwords and private keys are stored only in `~/.dsh/.credentials.yaml` with owner-only permissions.

05Compatibility, maintenance and safety notes

  • Targets DSH Desktop / Web with `engines.dsh` >= 0.2.0; without `sidebarRightTabs` and `sidebarRight` the Agent tools still run but the terminal UI does not appear.
  • High-impact Agent commands (destructive shell, `sftp_delete`, dangerous SQL) suspend until the host approval UI accepts or rejects; absent approval channel means fail-closed rejection.
  • Server metadata lives in DSH local storage; passwords and private keys are stored only in `~/.dsh/.credentials.yaml` with owner-only permissions.
  • README notes Desktop full UI interaction is still pending hands-on verification on some releases; plan extra smoke testing on Desktop builds.
2026-08-152026-11-19v0.4.12

MIT · last push 2026-11-19 · release v0.4.12

06Frequently asked questions

Which DSH versions and APIs does SSH Ops need?

The README declares `engines.dsh` >= 0.2.0 for Desktop and Web profiles. The host must also expose `sidebarRightTabs` and `sidebarRight`; older hosts without them keep Agent SSH/SFTP/DB tools but lose the terminal UI.

How should I install it?

Preferred path is npm package `dsh-ssh-ops` inside DSH plugin management. For git installs run `dsh plugin --profile web add github:caoyiwei850/dsh-ssh-ops#v0.4.12`, then restart with `dsh web` and open the **SSH** tab.

Where are SSH passwords and keys stored?

Server names and connection metadata sit in DSH local storage. Passwords, PEM keys and passphrases go only to `~/.dsh/.credentials.yaml` with owner-only permissions and are not shown in the browser UI or Agent context.

What happens when the Agent tries a dangerous command?

Destructive shell patterns, `sftp_delete`, and high-risk SQL trigger the host session approval UI; the call stays suspended until you approve or reject. Simple Agent `rm` requests move files to a remote trash folder instead of hard deletion when approved.

08Data and sources

  • Author-claimedgithub.coma6e03ba69423…

    > DeepSeek Harness 的 SSH 运维插件:在主对话中驱动当前服务器,同时在右侧保留真实的交互式终端,并集成文件管理、端口转发与数据库管理。

  • Author-claimedgithub.coma6e03ba69423…

    在 DSH 的插件管理中按包名 `dsh-ssh-ops` 从 npm 安装。

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-20. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.