dsh-workspace: SSH Remote Workspaces for DeepSeek Harness
yh4922/dsh-workspace
A remote workspace plugin for DeepSeek Harness (DSH): manage SSH hosts, open remote terminals, browse and edit remote files and Git, and add remote directories as workspaces so the Agent's file operations and commands run on the remote machine.
dsh-workspace is a DSH plugin that extends DeepSeek Harness beyond the local machine onto remote servers. It removes the limitation of an agent being confined to local files by letting you manage SSH hosts inside DSH, open remote terminals, browse and edit remote files, inspect remote Git, and add remote directories as workspaces so the agent's file operations and commands execute on the remote host. It also brings a master-password credential vault, jump-host chains and proxy support, a terminal that reconnects after drops, and an editor with conflict detection, making it a fit for developers running AI workflows on servers.
How to Install
dsh plugin --profile web add @yh4922/dsh-workspace- Category
- Development & Operations
- Platform
- DSH Plugin
- Author
- yh4922
- Distribution
- Plugin
dsh-workspace Key Features
dsh-workspace Repo Summary
What Does It Do?
Remote Workspace is a DSH plugin for DeepSeek Harness that extends the harness's file operations and commands onto remote machines over SSH. It solves the problem of an agent being stuck on local files by letting you manage SSH hosts, open remote terminals, browse and edit remote files, inspect remote Git, and add remote directories as workspaces. It is maintained by yh4922, written in TypeScript, and released under the MIT license.
Core Features
- Host management: multi-level groups, inherited group defaults, jump-host chains, and SOCKS5 / HTTP proxies, with host fingerprints recorded on first connect and blocked when they later change.
- Credential vault: passwords and private keys are encrypted with a master password and stored locally, with an optional remember-on-this-machine auto-unlock.
- Remote files and terminal: directory tree, an editor with syntax highlighting and conflict detection, Markdown / HTML / image preview, upload and download, plus an interactive SSH terminal that reconnects automatically after a drop.
- Remote Git: changes, diffs, and commit history with a fork graph; you can edit and commit on a branch without checking it out locally.
- Remote agent tools: inside a remote workspace session, the agent's read, write, edit, glob, grep, and bash all run on the remote host while local sessions stay untouched.
How to Use This Plugin?
After enabling it in DSH, open Remote Workspace from the left sidebar, set a master password on first use, then create a host (optionally inside a group) and click Test Connection to confirm it works. Use the Host / Files / Terminal / Connection Log tabs to manage hosts, browse files, and open terminals; click DSH's Add Workspace and pick a remote host and directory to create a remote workspace. Inside a remote workspace session, the right sidebar can open Remote Files, Remote Git, and SSH Terminal, and the Global Config tab holds the auto-unlock switch plus version information. Sidebar-related features depend on a companion sidebar plugin that must be installed and enabled first.
How to Troubleshoot This Plugin?
- Build scripts blocked during setup: the plugin relies on an SSH library with native build scripts, so click Allow these scripts and retry in the plugin manager's failure screen, or approve the scripts as prompted on the command line.
- Old code still running after an upgrade: earlier versions shipped under a different package name, so remove the old package before installing the new one, otherwise both remain installed.
- Re-adding the same source rolls back with a message that the installed package cannot be determined: remove it first, then install again.
- Uninstalling or upgrading while DSH Desktop is running has crashed DSH before: quit DSH first.
- Installing straight from the Git repository fails: the repo contains no build output, so use a release package or a local path instead.
This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: yh4922/dsh-workspace. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.
DSH Plugin FAQ
