dshworks/dsh-watch

dsh-watch is a purpose-built plugin for DeepSeek Harness (DSH), created exclusively to add background stream monitoring capabilities to DSH's native job subsystem. To install it, users run the command dsh plugin --profile <profile-name> add @dshworks/dsh-watch, which requires pnpm to be available on the system’s PATH. It supports two types of watch sources: running commands that are spawned once, and existing or pending files to tail. Each watch is treated as a first-class background job within DSH, so users can manage it with DSH's built-in job commands like job_list, job_output, and job_kill.

This plugin is designed for users who need to run unattended long-term monitoring tasks on DSH, such as tracking application error logs or waiting for a build process to output a ready signal. After declaring watch configurations in the DSH profile, the plugin runs as a lightweight daemon that stays idle when no matching content is found, consuming almost no system resources. When new matching lines are detected, it batches them into a single notice to avoid excessive wakeups, then sends the notice to wake the idle DSH agent for processing.

The plugin is released under the permissive MIT license, meaning it is free to use, modify, and distribute for both personal and commercial purposes. It has several documented limitations that users should be aware of before use: it uses polling instead of system-level inotify or kqueue interfaces, so latency below the poll interval is not possible. It also does not support resuming watches across DSH restarts, any existing watches are terminated when the current DSH session ends, and stderr from command sources cannot be filtered separately from stdout. All these limitations are clearly documented in the project’s README for reference.