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.
Install
dsh plugin --profile web add github:MathieuPortmann/dsh-plan-runnerDistributed 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
- Repo: MathieuPortmann/dsh-plan-runner
- Category: Workflow & Automation
- Stars: 0
- Version: Unpinned; this line installs from the GitHub default branch
Alternatives
AK-blank/dsh-plugin-auto-answer · alib8b8/dsh-plugin-aflare · PerryLink/dsh-autotier