dsh-loop
English | 中文
A DeepSeek Harness (DSH)
plugin that adds a human-facing /loop slash command for timed, recurring
agent loops.
/loop 30m fires one immediate tick, then re-prompts the agent once per
30-minute interval (measured from the moment the agent returns to idle after
the previous tick) until you stop it with /loop stop.
Install
# from GitHub (works immediately — no npm publish required)
dsh plugin --profile web add git+https://github.com/XiaoWind/dsh-loop.git
# or from npm, once published
dsh plugin --profile web add dsh-loop
The dsh plugin command forwards to pnpm inside the web profile directory,
then reconciles the profile's dsh.profile.bundles layer list. Because this
package declares dsh.bundle.patch, it joins the layer stack automatically.
Restart the Web app after installing.
The plugin injects the commands service, so it activates only in profiles
that compose a command adapter — the shipped web profile does.
Usage
| Command | Result |
|---|
/loop 30m | Start a loop: tick now, then once every 30 minutes. Keeps any current objective. |
/loop 30m fix the tests | Start a 30-minute loop toward an objective. |
/loop fix the tests | Start a loop toward an objective at the default interval. |
/loop 1h30m | Combined durations are supported. |
/loop resume | Resume the loop saved before a restart. |
/loop or /loop status | Show the running loop. |
/loop stop | Stop the loop. |
/loop help | Show help. |
Intervals are a whitespace-free sequence of <number><unit> tokens where
unit is one of ms, s, m, h, d — for example 90s, 30m, 1h30m,
2h.
A leading duration token is the interval and the remainder is the objective;
with no leading duration, the whole input is the objective and the default
interval applies.
Semantics
- First tick is immediate. Each later tick fires
interval after the agent
returns to idle, so a running turn is never interrupted.
- Saved across restarts. The loop config is persisted to
$DSH_HOME/dsh-loop/<sessionId>.json. When you reopen the session after a
restart, the plugin asks whether to continue the saved loop (Continue /
Stop); /loop resume restarts it manually when no prompt is available.
/loop stop discards the saved loop.
- Manual stop. The loop runs until you run
/loop stop, the agent is
disposed, or the plugin is unloaded. There is no automatic completion
detection.
Configuration
Set config.defaultIntervalMs (milliseconds) to change the interval used by a
bare /loop <objective> with no leading duration token. The default is
600000 (10 minutes).
# your profile's cordis.patch.yml
- id: loop
config:
defaultIntervalMs: 900000
Development
# syntax check
node --check lib/index.js
# duration-parser unit test
node test/duration.test.mjs
The plugin is a single-file ESM Cordis function plugin (lib/index.js) with no
build step. It exports apply, inject, and name, and the bundle layer
cordis.patch.yml inserts it into the profile composition.
License
MIT
