dsh-background-agents DSH plugin

This plugin upgrades DSH's built-in background jobs to full background agent sessions. It allows you to start a durable child agent that can be messaged, steered, and interrupted without leaving your session. It includes auto-reporting, idle archiving, and a Web UI panel for managing agents.

skills-workflows remote-execution

How to install the dsh-background-agents DSH plugin

dsh plugin --profile <name> add "github:PerryLink/dsh-background-agents#v0.4.0

This source command needs manual review. Copying does not run it.

dsh-background-agents DSH plugin data source

dsh-background-agents DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-background-agents DSH plugin can do

Start a continuable background agent with optional tool_filter, persona, and max_depth configuration.
Send messages to an agent via bg_message for corrections or additional work.
List all agents with status, activity, message count, and last activity time using bg_list.
Retrieve the latest output of an agent with bg_result, including reasoning fallback.
Automatic progress injection after each child turn, with throttling and optional wakeup.

Where the dsh-background-agents DSH plugin fits

Monitor a code repository for test failures using a persistent background agent.
Delegate a long-running research task to a background agent while continuing the main conversation.
Send incremental updates or corrections to a background agent for ongoing work.
Manage multiple background agents from a single dashboard panel in the Web UI.
Recover and resume background agents after a DSH restart.

Who the dsh-background-agents DSH plugin is for

DSH users who need to run long-lived background tasks that can be interactively steered.
Developers automating complex workflows with multiple parallel agent sessions.

dsh-background-agents DSH plugin limitations

Requires the subagent spine (dsh-subagent, dsh-subagent-spawn-in-process, dsh-session-projection) to be mounted.
The number of non-archived background agents is capped at 4 by default (configurable).
Idle archiving is enabled by default; agents inactive for 120 minutes are archived (configurable).
Not designed for cross-machine or remote agent execution.
Scheduled triggering is not supported; this plugin focuses on interactive steering only.

dsh-background-agents DSH plugin: from the repository README

Quoted from the PerryLink/dsh-background-agents README, the upstream source of the dsh-background-agents DSH plugin. Copyright remains with the original authors.

> Interactive, long-session background agents for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness). Start a durable child agent that keeps working while you keep talking —watch its progress, steer it with messages, and stop it, all without leaving your session. [English](./README.md) 路 [涓枃](./README.zh.md) 路 [Espa帽ol](./README.es.md) 路 [Portugu锚s](./README.pt.md) 路 [啶灌た啶ㄠ啶︵](./README.hi.md) [![license](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](./LICENSE) [![topic: dsh-plugin](https://img.shields.io/badge/topic-dsh--plugin-4d6bfe)](https://github.com/topics/dsh-plugin) [![topic: dsh](https://img.shields.io/badge/topic-dsh-4d6bfe)](https://github.com/topics/dsh) DSH's built-in background *jobs* are fire-and-forget tool executions: you can read output and kill them, but you cannot talk to them. `dsh-background-agents` upgrades that to **full background agent sessions** on the official subagent seam —a continuable child conversation you can message, steer, and interrupt at any time, while an injected progress line after each of its turns keeps you (and the model) in the loop. ## What you get - **`background_agent`** —start a durable, continu

Read the full READMERepository license: Apache-2.0

dsh-background-agents DSH plugin questions

How to install dsh-background-agents?

Install via the DSH plugin CLI: `dsh plugin --profile <name> add "github:PerryLink/dsh-background-agents#v0.4.0"`. Prefer a pinned git ref to avoid build steps; the package is also on npm as `dsh-background-agents`.

How to start a background agent?

In any session, ask the model or use the tool directly: `background_agent "watch the repo for test failures" (label: test-watch)`. The agent will start and return an agent ID immediately.

How to send a message to an existing background agent?

Use the `bg_message` tool with the agent ID: `bg_message <agentId> "also check the snapshot tests now"`. The message is delivered through the official FIFO inbox.

Do background agents survive a DSH restart?

Yes, agents persisted through the structured fact channel are recovered after a restart. The `bg_list` tool will show them with their status.

What is the default idle timeout?

By default, agents inactive for 120 minutes are archived. You can configure `idleTimeoutMinutes` in the plugin config, or disable `autoArchive` to keep them parked.