titanwings/dsh-plannotator

“Change the third step” is vague. A comment attached to the exact sentence preserves the context the agent needs to revise the plan correctly.

Select exact text → comment on several risks → send one review → approve when ready.

🎯 Why dsh-plannotator

Coding agents are good at producing plans, but a binary Approve / Reject decision is too coarse for serious work. Architecture migrations, API changes, security fixes, and rollout plans often need several independent corrections before implementation begins.

dsh-plannotator turns DSH’s native Plan Review into a compact gate plus a responsive companion panel. On a wide screen, the conversation and review occupy separate columns, so opening the panel never covers chat text. Collapse it to a slim edge rail and reopen it without settling the request. Your comments still travel through DSH’s existing response flow as structured Markdown, so the agent can revise the proposal in plan mode and ask for review again.

This is an unofficial integration inspired by Plannotator.

🧰 Features

Comment on the exact claim—not “somewhere in the plan”

Drag over text for a precise annotation, or double-click a paragraph, list item, heading, bold phrase, or code fragment. The review keeps the quote and comment together within the current plan revision.

Review the whole plan in one pass

Collect multiple comments across compatibility, security, rollback, and tests; add overall feedback; click an annotation in the review panel to return to its source; then send one coherent review. This keeps the review compact and less ambiguous than a sequence of detached chat messages.

Collapse the review without losing your place

The review panel can shrink to a blue edge rail while the compact composer gate remains visible. Reopen either control to continue with the same comments and overall feedback.

Return actionable feedback to the agent

Send feedback answers the real exit_plan_mode interaction. DSH records the quoted plan text, each requested change, and the overall feedback in the tool result and Session Log. The agent remains in plan mode and can immediately produce a revised proposal.

Protect unfinished reviews

Unsent comments are saved locally in the browser, isolated by Session, pending request, and plan revision. If you try to approve while feedback is still pending, the plugin requires an explicit second confirmation instead of silently discarding your work.

📦 Install

Install the GitHub bundle into the DSH Web profile, then restart dsh web:

dsh plugin --profile web add github:titanwings/dsh-plannotator#v0.1.3

The repository ships its built Host and Web bundles, so installation runs no package build script and needs no allowBuilds entry. Pin a reviewed commit SHA instead of the release tag when you need an exact source revision.