jmcc-guo/dsh-ssh

@jmcc-guo/dsh-ssh

English · 简体中文

AI-managed SSH connections with a live multi-tab terminal panel for DeepSeek Harness.

SSH terminal panel + AI connection manager for DeepSeek Harness (DSH).

The AI agent can autonomously create, address, and tear down SSH connections right from the conversation (ssh_connect / ssh_exec / ssh_list / ssh_status / ssh_disconnect / ssh_exec_read / ssh_exec_kill / ssh_delete), while a XShell/Uniterm-style multi-tab terminal panel in the Web GUI shows every command — model and human — in real time on the same screen.

Features

• Model-driven connection lifecycle — the agent connects by name or by parameters, runs commands with exit codes and readable failures, lists and inspects AI-managed connections, disconnects and deletes them. The same server may hold several independent connections (each with its own name, session state and command queue).
• Auto-save & reuse — every connection is persisted by name (globally unique). After a DSH restart, ssh_exec on a saved name automatically re-establishes the connection from its saved settings.
• Unified AI management — there is no source distinction: every saved connection, whether created by the AI (ssh_connect) or from the Settings page, is managed by the AI agent. It appears in ssh_list and is immediately addressable by ssh_exec / ssh_status / ssh_disconnect / ssh_delete — no transfer step exists or is needed.
• Keep-alive & reconnect — idle keep-alive per connection; automatic reconnect only for unexpected drops (network blips, server resets) with exponential backoff (bounded attempts); every explicit disconnect stays down (tab close, ssh_disconnect, Settings "Disconnect" button). A "reconnected — the shell state was reset" notice is shown after an automatic reconnect.
• Execution mutex (every connection) — while an AI command runs on a connection, human keystrokes are dropped server-side with a visible "AI is executing…" hint (the user may only type when the AI is not executing on that terminal); a model ssh_exec against a connection whose shared terminal shell is still active waits until the shell falls quiet (no output/input for shellQuietWaitMs, default 2 s) or returns a readable "busy" result instead of interleaving output.
• Tab semantics — closing a tab disconnects immediately (no confirmation dialog); AI ssh_disconnect keeps the tab open showing "disconnected" (one click to reconnect); a model connect that has no tab re-opens one automatically. Connecting a saved connection (tab bar "+", the Settings-page Connect button) never rejects an already-open connection: when a tab for that connection is already open, the call opens a FRESH independent session in a new tab — even when the same connection is already connected in another tab — and only connects the primary session (the one the model tools address) when no tab is open yet.
• Live terminal panel — two surfaces, one state — the panel body can live in DSH's native right details column (the conversation shrinks instead of being covered; closing restores the original right column untouched; a slim SSH rail on the right edge reopens it) or inside dsh-better-sidebar: when that plugin is installed, the same panel body registers as a sidebar tab (dsh-ssh:terminal — visible in its + menu, with a live connection-count badge), and the AI-connect auto-open lands there (opening and expanding the sidebar). Both surfaces share the one host-managed state stream, so switching never forks the terminals. panelSurface (see settings below) chooses the surface: auto (default — sidebar when installed), sidebar (prefer sidebar), native (always the built-in column). Without dsh-better-sidebar everything falls back to the native column automatically. Each connection owns one real interactive shell (PTY): the login banner (motd / Last login), the remote prompt user@host:path$, input echo and cd updates all come from the remote shell, exactly like a native SSH client. There is no input box and no copy control — click the terminal and type; keystrokes go straight into the remote shell (arrows, Tab, Ctrl-C, paste, IME supported). A blinking block cursor shows while the terminal is focused. AI-run commands appear in the same scrollback with source tags. Multi-tab, ANSI colors, scrollback. The view stays pinned to the newest output as it arrives — even large output bursts follow to the bottom; scrolling up to read history is respected (no forced jump), but whenever the AI starts operating the connection the terminal slides back to the bottom so the AI's live output is visible.
• Settings page — "SSH Connections" under Settings manages everything: create, edit (rename supported), delete connections and their credentials (passwords / private keys stored in the DSH credential store), and connect/disconnect. The terminal column itself contains no CRUD.
• Credential hygiene — passwords and private keys live in the DSH credential store under generated references; the records file, logs and tool results never contain secret material; inline secrets in tool arguments are rejected with guidance; auth failures return scrubbed, readable reasons.
• Settings — the dsh-ssh settings namespace (heartbeat, reconnect policy, timeouts, output caps, records path) can be overridden through the DSH settings system / profile patch.
• Bilingual UI — Chinese and English copy.