dsh-bgjobs: Keep DeepSeek Harness Commands Running as Background Jobs
bitsmug/dsh-bgjobs
Submits commands as background jobs that keep running after DSH exits, with a live web panel plus offline CLI/GUI management.
dsh-bgjobs is a standalone background job plugin for DeepSeek Harness that hands commands submitted in a session to Windows Task Scheduler, so closing DSH or the web page never interrupts execution. It targets the pain of babysitting long tasks, letting large downloads, batch scripts, builds, and data sync or export jobs run while you walk away. Core abilities include a floating output panel refreshed every second, completion Toasts with optional callbacks to the creating agent, automatic tracking after a restart, and offline command-line and graphical management that works without DSH.
How to Install
dsh plugin --profile web add bgjobs- Category
- Tools & Capabilities
- Platform
- DSH Plugin
- Author
- bitsmug
- Distribution
- Plugin
dsh-bgjobs Key Features
dsh-bgjobs Repo Summary
What Does It Do?
bgjobs is a DSH plugin for DeepSeek Harness that hands commands submitted inside DSH to the Windows Task Scheduler so they run independently of the DSH process. It solves the problem of having to babysit long-running work: closing DSH or the web page does not stop execution, which suits large downloads, batch scripts, builds, and data sync or export jobs. The plugin is maintained by bitsmug under the MIT license and was last updated in 2026-09.
Core Features
- Out-of-process execution: jobs are managed via schtasks, survive DSH crashes or shutdown, and delete their scheduled task on completion for zero residue.
- Live output panel: a floating panel in the lower-right corner refreshes output every second, and can be dragged, minimized to a floating ball, collapsed to a task list, and re-skinned with the theme, grouped by workspace.
- Completion notifications and reconnection: a Toast appears when a job exits, notifications can optionally be sent back to the creating agent, and DSH restores tracking after a restart while old job ids remain queryable from disk.
- Offline management: a CLI and GUI that do not depend on DSH offer list, status, log, submit, kill, and cleanup operations.
- Three submission engines: bat syntax, PowerShell syntax, and submitting a single MCP tool call as a background job (a settings toggle, off by default).
- Optional sandbox: PowerShell jobs can be submitted with a sandbox constraint that keeps file permissions no higher than the current session mode.
How to Use This Plugin?
After enabling it in DSH and restarting, a background task monitor panel appears in the lower-right corner of the web page and the agent gains submission, status, and wait tools. When asking the agent to submit a job, provide a name, a command, and a working directory, choosing bat or PowerShell syntax as needed; set a wait value to block for the result and enable the notify parameter for a callback. While jobs run you can watch live output in the panel and drag or batch-clean finished tasks, or fall back to the standalone CLI and GUI when DSH is offline. MCP jobs require turning on the MCP task toggle in settings and registering a server or importing one from the DSH configuration.
This page is an independent rewrite of the plugin's official README — for authoritative documentation and the latest changes, refer to the source: bitsmug/dsh-bgjobs. The plugin is third-party code that runs on your machine once installed; inclusion does not imply endorsement — please review the source before installing.