Foreword¶

In the development scenarios of DeepSeek Harness (DSH), if you need to reuse the Windows OpenSSH agent in a WSL (Windows Subsystem for Linux) environment, you typically need to rely on npiperelay for bridging. This kind of configuration involves file paths, permissions, and connection states, making troubleshooting relatively cumbersome. The dsh-wsl-ssh-agent plugin provides a diagnostic solution to help verify that the forwarding path is working properly without leaking keys.

Plugin Introduction¶

This is a DeepSeek Harness plugin that belongs to the dsh-wsl-kit suite. Its core function is to diagnose the SSH agent socket in WSL and the npiperelay bridging status. Unlike directly inspecting key material, this tool focuses on checking the availability of the connection path and ensuring configuration correctness.

Core Features¶

1. Diagnose the WSL SSH agent socket
   Checks whether the SSH agent socket inside WSL exists and is accessible.

2. Check npiperelay bridging
   Verifies whether the npiperelay bridge on the Windows side is working properly, ensuring that the Windows agent can be correctly forwarded into WSL through a pipe.

3. Secure diagnostics
   The entire diagnostic process does not print key material, preserving security.

Installation and Enablement¶

Run the following command to install the plugin:

dsh plugin --profile web add github:173787247/dsh-wsl-ssh-agent

After installation, restart dsh web and open a new session. You can then use the corresponding tool.

Typical Usage¶

In a new session, invoke the tool ssh_agent_hint. This tool outputs diagnostic information for the WSL SSH agent and npiperelay, helping determine whether the configuration is correct.

Compatibility and Notes¶

• Plugin version: 0.2.0
• Minimum DSH version: >= 0.1.2
• License: MIT

Conclusion¶

This plugin provides a standardized diagnostic approach for debugging SSH agent forwarding in a WSL environment. Through non-invasive checks, it avoids the exposure of sensitive information. For more technical details and troubleshooting procedures, refer to the dsh-wsl-kit repository.