dsh-scout

When an agent needs to know which machine it is running on, which commands are on PATH, which toolchains are installed at what version, or how much CPU and disk remain, the traditional approach is trial-and-error: guess a command, run it, guess the next one. That is slow and burns tokens on discovery. dsh-scout collapses the process into a single environment_probe call that returns environment, PATH commands, software versions, hardware resources, listening ports, system services, workspace toolchain signals, and even serial, USB, and GPU details in one structured JSON response ready for programmatic consumption.

Every probe is strictly read-only: no shell command ever receives model-supplied input, the full process.env is never exposed, subprocess probes carry per-call timeouts, concurrency caps, and TTL caches, and the workspace probe rejects path traversal and symlink escapes. Battery-less desktops and VMs report battery.available as false rather than an error. The slower backends (system_profiler, lsusb, CIM) cache results automatically, so a single array call covers serial, USB, network, and GPU probes for embedded and robot debugging workflows.

Installed as a dsh bundle, the plugin ships its own patch layer and an env-probe skill that appears in every agent session automatically. It requires no changes to the Harness repository. It is well suited to embedded and robotics developers, cross-platform DevOps teams, and any DeepSeek Harness user who wants the agent to accurately perceive its runtime environment before acting.