Skip to content
  • Home
  • Plugin manual
  • dsh-loop

vlln/dsh-loop

40Last commit Aug 15, 2026

dsh-loop DSH plugin

Loop is a DSH bundle plugin that lets you run timed loops: repeatedly send a prompt to the current agent at a fixed interval. It aligns with Claude Code's /loop semantics and supports multiple loops concurrently in one session. The plugin provides a /loop command, a loop tool for model self-regulation, and a dock status bar showing active loops.

developer-toolsskills-workflows

How to install the dsh-loop DSH plugin

dsh plugin --profile web add "github:vlln/dsh-loop#main

Copying does not run this command. Review the repository and version before installing the dsh-loop DSH plugin.

dsh-loop DSH plugin data source

dsh-loop DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-loop DSH plugin can do

  • Start, stop, list, and check status of timed loops via the /loop command or the loop tool.
  • Multi-loop concurrency: run multiple loops simultaneously in the same conversation.
  • Live status bar in the dock slot above the input box, showing loop count, prompt, interval, and next run time.
  • Model self-regulation: the loop tool allows the model to start/stop/query loops on its own.
  • Interval formats: supports 5m, 30s, 1h, 2d or bare numbers interpreted as minutes.

Where the dsh-loop DSH plugin fits

  • Polling: periodically check a service status or API endpoint.
  • PR watch: automatically re-run checks on a deploy branch at intervals.
  • Build-fix-test cycle: repeatedly run a build, fix errors, and test until green.
  • Automated monitoring: keep an eye on CI/CD pipelines or deployment health.
  • Continuous improvement: repeatedly prompt the agent to refine code or documentation.

Who the dsh-loop DSH plugin is for

  • Developers who need automated periodic prompts in their DSH agent sessions.
  • DevOps engineers looking to integrate loop-based monitoring or CI/CD workflows.
  • Power users who run long-running agent tasks and want to automate recurring checks.

dsh-loop DSH plugin limitations

  • Loops are not persisted across harness restarts; they disappear when the process exits.
  • Requires DSH (DeepSeek Harness) with the web profile and bundle plugin support.
  • Only works within the DSH environment; not a standalone solution.
  • The plugin is still in early development (MIT license, example plugin).

dsh-loop DSH plugin: from the repository README

Quoted from the vlln/dsh-loop README, the upstream source of the dsh-loop DSH plugin. Copyright remains with the original authors.

按固定间隔向当前 agent 重复投递 prompt——适合轮询、PR 看护、build-fix-test 循环。对齐 Claude Code 的 `/loop` 语义，**一个会话可同时跑多个循环**。形态：官方 **bundle 插件**（`dsh.bundle` + dshClient 通道），0 patch。 ## 效果 ![loop 状态条（真实运行截图：对话页 dock 双循环）](https://cdn.jsdelivr.net/gh/vlln/dsh-loop@main/docs/preview/loop.png) ## 能力 **工具**（`defineTool` 注册，模型每轮可自调节）： | 工具 | 说明 | |---|---| | `loop` | start（启动新循环）/ stop（停指定或全部）/ status / list（列出当前会话循环） | **命令**（用户侧）： | 命令 | 说明 | |---|---| | `/loop [间隔] <prompt>` | 启动新循环（间隔 `5m`/`30s`/`1h`/`2d` 或裸数字=分钟；裸 `/loop` 用内置维护 prompt） | | `/loop list` | 列出当前会话全部循环（含 id） | | `/loop stop <id>` / `/loop stop` | 停指定循环 / 停全部 | **UI**（对话页输入框上方 dock 槽）： | 功能 | 说明 | |---|---| | 活动状态条 | `● ⟳ 循环中 · <prompt> · 5m · 下次 23s`，多循环堆叠、带 loop id | ## 安装 **推荐：git 源一行安装**（构建产物已入库，git 源不触发构建）： ```sh dsh plugin --profile web add "github:vlln/dsh-loop#main" ``` 或本地目录（有源码时）：`git clone` 后 `cd dsh-loop && dsh plugin --profile web add .`。 装完 **重启 web** 生效（bundle 挂载在启动时合成）；之后可在设置页「插件」面板停用/启用（运行时生效 + 持久化）。 ## 使用 ```sh # 用户侧 /loop 5m 检查 deploy 分支的 PR # 每 5 分钟投递一次 /loop list # loop-1: every 5m — 检查 deploy 分支的 PR /loop stop loop-1 # 停指定 /loop stop

Read the full READMERepository license: MIT

dsh-loop DSH plugin questions

How do I install the loop plugin in DSH?

Run the command `dsh plugin --profile web add "github:vlln/dsh-loop#main"` in your terminal. After installation, restart the web interface to activate the bundle plugin. You can also clone the repo and use `dsh plugin --profile web add .` from the cloned directory.

Can I run multiple loops at the same time?

Yes, the loop plugin supports multiple concurrent loops in the same conversation. Each loop gets a unique ID (e.g., loop-1, loop-2). You can list them with `/loop list` and stop specific ones with `/loop stop <id>`.

What interval formats are supported?

You can use formats like `5m` (5 minutes), `30s` (30 seconds), `1h` (1 hour), `2d` (2 days), or a bare number which is interpreted as minutes. For example, `/loop 10 check status` will run every 10 minutes.

Are loops persisted across restarts?

No, loops are not persisted. They exist only during the current harness process. If the process exits or restarts, all loops are lost. This behavior matches Claude Code's /loop semantics.

Can I use the loop tool from the model instead of the command?

Yes, the plugin registers a `loop` tool (`defineTool`) that the model can call autonomously. The model can start, stop, list, or check status of loops. This enables self-regulation within the agent workflow.