DeepSeek Harness PluginManifest Valid

dsh-deadman

Deadman switch watchdog plugin for DeepSeek Harness that runs shell commands when no agents report activity.

Developer ToolsSecurity & Policy

0GitHub Stars0ForksUpdated2026-09-30

Source

Install

$ dsh plugin --profile web add /path/to/dsh-deadman

Plugin Overview & Capabilities

AI-assisted organization based on the public repository snapshot. The content must be grounded in source evidence and does not replace compatibility or security verification.

source-grounded

dsh-deadman is a watchdog and deadman switch plugin for DeepSeek Harness (dsh). It monitors agent activity during unattended tasks such as long builds, model training, or batch rendering. By checking whether agents are making progress or explicitly holding off the timer, it automatically triggers configured shell commands (e.g., system shutdown or cleanup) when all work stops or sessions become inactive.

Key Capabilities

Arm deadman switch watchdogs with customizable delays and re-check intervals (`deadman_arm`)
Signal agent activity and postpone switch execution (`deadman_hold`) via tool calls or filesystem marker files
Disarm scheduled switches with session ownership validation (`deadman_disarm`)
Slash commands support for listing and cancelling tasks (`/deadman`, `/deadman all`, `/deadman cancel`)
Persistent task state across dsh restarts via local JSON storage
Fail-open threshold enforcement and handling of open user question timeouts

Useful For

Automatically stopping or shutting down cloud compute instances when background batch or compilation jobs complete
Releasing system resources or sending external alerts when an agent session hangs or runs out of credits
Coordinating multi-agent long-running workflows without premature termination

Who It Fits

Developers running long-running headless or unattended jobs with DeepSeek Harness
DevOps and ML engineers managing cloud instances and compute resource costs
DSH automation engineers configuring unattended agent pipelines

Documented Limitations

Requires a long-running DSH profile process (like web/daemon); does not run in short-lived single-run CLI processes after process exit
Assumes a single-writer environment on tasks.json; concurrent writes across multiple processes can overwrite task state
Only tracks direct child sub-agents when progressScope is set to owner
Command execution carries security risks since commands are executed with system privileges specified at arming time
Does not guarantee exactly-once execution if the host crashes during command invocation

DSH Compatibility

Version-specific runtime evidence collected by DSH Plugin. A missing result means we have not tested that combination yet.

Not tested yetNo runtime compatibility tests have been published yet.

Security Signals

Objective signals discovered from package metadata and source inspection. These are not a guarantee that a plugin is safe.

Dependency Counts

package.json declares 2 runtime, 0 development, 5 peer, and 0 optional dependencies.

info

Dsh Bundle Declared

package.json declares DSH bundle metadata.

info

License Declared

GitHub reports the repository license as MIT.

info

Package Manifest Available

A root package.json was captured and can be inspected by the registry.

info

Source Available

Public GitHub source metadata is available for this registry snapshot.

info

Source & Registry Notes

Public provenance, Registry classification, and the latest source check for this entry, kept separate from runtime verification.

Source repository: 0gl20shk0sbt36/dsh-deadman
Registry source: GitHub · dsh-plugin topic
Registry classification: Plugin
Source checked: 8f642fe · 2026-10-12

This project is independently indexed from public source information. DSH Plugin is not affiliated with DeepSeek or the plugin author. Always check the author repository before installation.