deepseek-harness/packages/ssh/README.md

---

description: "The POSIX SSH provider family: shared connection, remote filesystem, managed subprocesses and file-effect sandbox."

kind: "package-group"

ssh/ — POSIX remote execution providers

English | 中文

Summary

This family runs files, ordinary processes, terminals and sandbox enforcement on one POSIX SSH host while the Harness stays local. A shared OpenSSH connection and installed helper support the existing filesystem, subprocess and sandbox interfaces. Use it in headless or custom profiles whose consumers honor provider-owned paths.

Table of Contents

• Packages
• Related documentation
• Dev Note

Packages

Package	Responsibility	Service
ssh	Connection, helper identity and transport lifecycle	ctx.ssh
fs-ssh	Remote file identity, reads and guarded atomic mutations	ctx.fs
subprocess-ssh	Executable lookup, processes, control streams and terminals	ctx.subprocess
sandbox-ssh	Remote file-effect confinement and enforcement facts	ctx.sandbox

Related documentation

• SSH subsystem — shared execution coordinates and transport ownership.
• POSIX SSH decision — alternatives, consequences and verification requirements.

Dev Note

Working context for maintainers — click to expand

Remote capability implementations retain the shared asynchronous terminal and cancellation interfaces. Local path access must never be inferred from a remote path string.