Introduction¶
DeepSeek Harness (DSH) is a plugin-based agent framework. Developers often want to keep large model inference and interaction local, while needing the agent to execute code or operate files on a remote GPU server. The morewax/dsh-remote-exec plugin bridges this gap by allowing the DSH process to run locally while switching the filesystem and shell context to a remote machine.
What It Is¶
This plugin provides SSH and MOSH drivers for DeepSeek Harness, enabling the Harness file tools and shell tools to operate on a remote machine. Its core value is unifying the local agent experience with remote compute resources.
Core Features¶
This plugin provides the following capabilities:
- SSH remote execution
- MOSH remote execution
- Remote file tools
- Remote shell tools
- Tailscale keyless authentication
Installation¶
Add the plugin using the official command:
dsh plugin --profile default add github:moreWax/dsh-remote-exec
Configuration and Usage¶
Reference the plugin in the DSH configuration and specify the driver and target information.
Basic YAML configuration example:
- id: remote-exec
name: '@morewax/dsh-remote-exec'
config:
driver: ssh # Driver type: ssh or mosh
host: gpu-box # Target hostname, or Tailscale MagicDNS name
user: me # Remote username
root: /home/me/work # Remote workspace path
tailscale: true # Enable Tailscale keyless authentication (for ssh/mosh)
Driver Differences:
| Driver | File and Execution | Interactive Terminal | Authentication |
|---|---|---|---|
ssh |
OpenSSH | ssh PTY | Key-based, or set tailscale: true |
mosh |
Via ssh transfer | Native mosh | Same as ssh |
Notes¶
- Version Compatibility: This plugin is built against DeepSeek Harness
0.1.1-rc.x(Developer Preview). - Environment Requirements: The local environment requires Node.js >= 22.
- Authentication: Before use, ensure you have SSH key access to the target host, or set up Tailscale identity for keyless authentication.
- Interactive Mode: Interactive use of MOSH follows standard mosh client behavior.
- Permission Scope: The plugin operates under the permissions of the current DSH process.
Summary¶
morewax/dsh-remote-exec enables the file and shell capabilities of DeepSeek Harness to operate directly on remote servers. If you need to control a remote GPU machine from your local environment, this plugin provides SSH and MOSH as two transfer options and supports Tailscale keyless authentication.