dsh-remote-ide — Cloud workspaces: run the agent on your Linux server over SSH

[harryopo]

dsh-remote-ide — Cloud workspaces: run the agent on your Linux server over SSH

Repo: https://github.com/harryopo/dsh-cloud-workspaces

Pick Cloud (SSH) in the workspace picker, and the coding agent works directly on your remote server: bash, read, write, edit, glob, grep — the entire built-in toolset — transparently execute over SSH. Files, search, editing and terminal all live on the remote box.

Zero install on the server. No vscode-server-style remote agent, no daemon — a stock OpenSSH server is the only requirement. Everything rides standard SSH channels (exec / SFTP / PTY via ssh2).

Highlights

• Transparent toolset redirect — the official ctx.fs (13 file methods) and ctx.subprocess seams are swapped for SSH-backed implementations, scoped to sessions whose cwd falls under a cloud placeholder. Local sessions are never touched.
• Shadow tools with the official UI — session-scoped remote bash/read/write/edit/glob/grep implement the official presentCall/presentResult presenters, so chat rows render as real terminal/read cards — expandable and copyable.
• SSH settings card (Settings → SSH Connections) — host manager with password auth (keyboard-interactive aware, works with PAM/Ubuntu servers) or private keys, ProxyJump chains, one-click connection test, remote directory browser (create/delete folders), and bind-any-directory-as-workspace.
• Cloud workspaces via the official registry — cloud placeholders are adopted by workspaceRegistry, show up in every session picker as host / path.
• Robust connection layer — ssh2 pooling, keepalive, broken-connection transparent rebuild, jump hops.
• Secrets stay server-side — write-only secret fields; the browser receives only a redacted view.

Install (from source; npm publish in progress)

git clone https://github.com/harryopo/dsh-cloud-workspaces.git
cd dsh-remote-ide && pnpm install && pnpm build
dsh plugin --profile web add link:C:\path\to\dsh-remote-ide

Restart dsh web, then: Settings → SSH Connections → add host → Add workspace → Cloud (SSH) tab → browse → use directory as workspace. Open a session on it and ask the agent to run pwd.

Quality

Built only on official @deepseek-ai/dsh-* SDK packages. 100 unit tests + 25 E2E tests over a real SSH server; verified end-to-end on a real box (openEuler).

Feedback and stars welcome — and thanks to the DSH team for the excellent plugin SDK and the capability-seam design that makes this kind of integration possible.

[harryopo]

Update 2026-09-18 — v0.3.0: remote background jobs 🚀

bash and ssh_exec now support run_in_background: true — long installs / builds / test suites run on the remote server as first-class DSH jobs (job_output / job_list / job_kill, completion notices, jobs UI all work out of the box). Under the hood: one persistent SSH exec channel per job (authoritative exit status, zero polling), incremental dd reads of a remote log, process-group kill.

Also since first post: preset-less transparent mode verified end-to-end on real servers (dual-tab workspace picker → official adoption → 7 same-name shadow tools in agent scope, with native terminal/read cards), plus a security pass (password storage converged into a 0600 store with Windows ACL tightening, prototype-pollution guard, read_image).

Release notes: https://github.com/harryopo/dsh-cloud-workspaces/releases/tag/v0.3.0