dsh-keep-awake

Firing up a primary agent, spawning a few subagents, and queuing background commands in DeepSeek Harness can keep a session busy for tens of minutes or even hours. The operating system, however, is indifferent to all that work. When its timer hits, it puts the machine to sleep, interrupting tasks, losing context, and discarding results. dsh-keep-awake bridges that gap: as long as any agent is running or any background task is still active, the system stays awake.

The plugin polls agent and job state every five seconds and also listens for agent/status, subagent start/end, and job-set-change events for instant re-scans. Upon detecting activity it spawns a platform-specific helper process—SetThreadExecutionState on Windows, caffeinate on macOS, systemd-inhibit on Linux—to hold the sleep flag. Once every task finishes, a configurable grace period (60 s by default, adjustable from 15 s to 5 min) kicks in; after it elapses the helper exits and the sleep policy is released automatically, so you are not needlessly locking down power management.

Beyond the automated guard, the settings page offers a manual hold toggle, an optional display-sleep block, and a live status panel showing running agent count, active background tasks, helper process PID, and more. Configuration persists in the profile settings.yaml, and the UI follows the global DSH language setting with instant switching. For developers who routinely run long-duration agentic workflows on a local machine, the plugin is install-and-forget—no more remembering to run caffeinate or tweak power plans by hand.