DSH Workflow

Save, compose and resume workflows using native DSH subagents.
DeepSeek Harness plugin

简体中文 · English

0.1.4 GitHub total downloads DSH 0.2.2-rc.1 GitHub Stars

Get started · Docs · Report an issue

## Quick start **Required environment:** DSH **0.2.2-rc.1**, Node.js **24.9.0+**. Subagents use host models and permissions and incur normal model usage. Resume re-executes calls after the successful prefix; check existing artifacts and side effects first. ### 1. Install Open **Plugins → Add plugin** in the DSH instance you use, then paste: ```text https://github.com/gulagala001/dsh-workflow/releases/download/v0.1.8-dsh.0.2.2-rc.1/dsh-workflow-plus-0.1.8-dsh.0.2.2-rc.1.tgz ``` Wait for active tasks to finish, then follow the host’s activation/restart prompt. Keep your existing profile and data. See the [installation guide](docs/install_EN.md) · [SHA256SUMS](https://github.com/gulagala001/dsh-workflow/releases/download/v0.1.8-dsh.0.2.2-rc.1/SHA256SUMS). ### 2. Try this first In a conversation with a configured model, ask: ```text Use workflow to review auth and storage in parallel, then summarize the findings. Do not modify files. ``` **Success looks like:** The workflow panel shows actual phases, members and status, with agents running as native child conversations. ## Turn repeated work into resumable workflows - **Compose steps**: use `parallel()`, `pipeline()`, `phase()` and `log()` to express actual dependencies and execution state. - **Save and reuse**: submit a script directly, use `scriptPath`, or save named project workflows. - **Resume and isolate**: resume after a successful call prefix. Use Git worktrees for file isolation and retain results for review and merging. ### A minimal workflow ```js export const meta = { name: 'review-modules', description: 'Review two modules', phases: [{ title: 'Review' }], }; phase('Review'); return await parallel([ () => agent('Review auth for correctness. Do not edit files.', { label: 'auth' }), () => agent('Review storage for correctness. Do not edit files.', { label: 'storage' }), ]); ``` The workflow entry beside the conversation title shows phases and members; agents run as native child conversations. `run_in_background: true` uses native Jobs, with `job_output` for inspection and `job_kill` to stop. [Complete usage](docs/workflow.md) ## Runtime boundaries | Capability | Conditions and behavior | | --- | --- | | Nested workflows | One level, sharing concurrency, call limits, cancellation and budget. | | `resumeFromRunId` | Reuses an unchanged successful prefix in the same conversation; later calls execute again. | | `isolation: 'worktree'` | Creates a separate checkout from current Git HEAD, retaining changes without automatic merging. | | Shared output-token target | Add `+500k` or `+1m` to the user message. Reaching it stops new dispatch while active calls can finish. | Without trustworthy usage, further dispatch stops. Model requests, network access and file permissions remain with the host and tool providers. ## FAQ
Does resuming repeat completed actions? Only an eligible successful call prefix is reused; later calls execute again. Check existing artifacts and external side effects. Resume is not transactional replay of arbitrary actions.
Does uninstalling remove scripts or worktrees? The plugin does not actively delete saved scripts, run records or worktrees. Project paths are `.omd/workflows/` and `.omd/worktrees/`; independent run and budget data lives under `DSH_HOME/dsh-workflow/`.
## Development and license The package is `dsh-workflow-plus`, distributed through fixed GitHub Releases. Do not substitute another author’s similarly named npm package. ```bash pnpm install --frozen-lockfile --ignore-scripts --config.strict-dep-builds=false pnpm build ``` [Architecture](docs/architecture.md). Licensed under [MIT](LICENSE); see [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md) for sources. ## Documentation and support | I want to | Where to go | | --- | --- | | Install, update or remove | [Installation guide](docs/install_EN.md) | | Learn the features and limits | [Documentation](docs/workflow.md) | | Read release changes | [Releases](https://github.com/gulagala001/dsh-workflow/releases) | | Report a problem | [Issues](https://github.com/gulagala001/dsh-workflow/issues) | For a bug report, include the full DSH and plugin versions, the entry point, minimal reproduction steps, and expected versus actual behavior. Remove private data before sharing logs or screenshots.

Back to top · Versions and downloads · Feedback

[Documentation structure and contributing](docs/documentation.md)