MathieuPortmann/dsh-plan-runner

A DSH plan runner for small local models: a Plan agent writes the steps, then each runs in a fresh child conversation with its own model and access level.

Separates planning from doing. A Plan agent explores read-only and records discrete steps; you approve, then each step executes in a fresh child conversation that sees only the objective, its own instructions, short summaries of earlier steps and the files it needs — so the context that derails a small model never accumulates. Each step declares a model and an access level (read, read-shell, write limited to its declared outputs, or full), and finishes with a fixed report of summary, files, decisions and open questions. The harness then runs the step's own checks (exists, contains, words, count, command exit 0), important steps get a read-only reviewer ending in VERDICT: OK or a problem list, a failure gets exactly one retry carrying the cause and a lesson, and a second failure proposes a finer split without changing anything until you accept. Repeated identical tool calls abort the step, for_each steps run once per item, and a run interrupted by a restart resumes from the current step.

Workflow & Automation ★ 0
View on GitHub ↗

Install

dsh plugin --profile web add github:MathieuPortmann/dsh-plan-runner

Distributed from GitHub only, with maintenance stated as best-effort and forks welcome. Needs the Plan preset, which the plugin's config section documents. Steps are recorded with plan_begin, plan_add_step and plan_show, and the plan is also written to PLAN-<name>.md, so an interrupted run leaves a readable plan behind.

Compatibility

Built for small local models that lose the thread on long tasks; the mechanism assumes the harness can run native subagents, and each step gets its own model, so a profile with only one configured route still works but gains less. A step that would exceed 60 percent of its model's context window is refused at planning time and must be split — a hard limit rather than a warning.

Details

Alternatives

AK-blank/dsh-plugin-auto-answer · alib8b8/dsh-plugin-aflare · PerryLink/dsh-autotier

More plugins in Workflow & Automation

Browse more in Workflow & Automation

Guides for Workflow & Automation plugins