dsh-plan-switch

dsh-plan-switch 📋

English | 简体中文

A one-click enter/exit Plan mode button for the DSH web input bar (a quick-click shortcut for /plan) — a plugin for DeepSeek Harness (dsh) web.

Unofficial project: independently developed and maintained by a community member, not an official DeepSeek product.

Screenshot

The checklist icon button at the left end of the input tool row (official DSH design tokens, follows dark/light theme).

Features

• One-click enter/exit Plan mode: a checklist icon button at the left end of the input tool row; clicking it runs the official /plan toggle command.
• Hides while Plan mode is active: the button hides itself and the official plan card takes over the status display — there is never a duplicated indicator.
• Pending-switch guard: while a /plan toggle is queued, the button is disabled (the same "switching" semantics as the official plan chip), so a stray click can't reverse the switch.
• Live state: the button follows the plan state through the official projection, so changes from any entry point (/plan command, official chip, agent switching mid-run) are reflected in real time.

Install

Official bundle install (one line):

dsh plugin --profile web add "github:a903067276-rgb/dsh-plan-switch#main"

Restart dsh web after installing (bundle layers are composed at startup). Requires pnpm on PATH (dsh plugin forwards to pnpm).

Manual mount (fallback): see docs/install.md — symlink into ~/.dsh/profiles/web/node_modules/ plus a single entry in ~/.dsh/cordis.patch.yml, then restart.

Usage

A checklist icon button appears at the left end of the input tool row (official DSH design tokens, follows dark/light theme). Click it to enter plan mode — the same as typing /plan. While plan mode is active the button hides itself: the official plan card takes over the status display, so there is never a duplicated indicator; while a /plan toggle is pending the button is disabled, so a second click can't reverse the switch.

Platform support

Platform	Status
macOS	✅ fully tested (development environment)
Linux	⚠️ expected to work (pure frontend button, no platform dependency), untested
Windows	⚠️ expected to work (pure frontend button, no platform dependency), untested

Requirements

• DSH web >= 0.1.0-rc.6 (run with dsh web) — the code calls commands.execute with the 3-argument contract (rc.8+) and auto-degrades to the 2-argument one on rc.6/rc.7
• Version compatibility:
• Maintenance policy: this plugin keeps evolving with the latest DSH releases; compatibility with older DSH versions is best-effort only and not guaranteed going forward.

Your DSH version	Install this	Note
0.1.0-rc.6 and newer (incl. 0.1.1-rc.1/rc.2)	main (v0.3.2+)	Best effort — 3-arg call with auto-degrade to 2 args on rc.6/rc.7 (verified locally on rc.6/rc.8, not guaranteed)
0.1.0-rc.8 and newer (conservative)	v0.3.1 — dsh plugin add github:a903067276-rgb/dsh-plan-switch#v0.3.1	Last build without the degrade logic
0.1.0-rc.6 – 0.1.0-rc.7 (conservative)	v0.3.0 — dsh plugin add github:a903067276-rgb/dsh-plan-switch#v0.3.0	2-argument commands.execute contract

• No host-side setup: the host half is a no-op — the whole plugin is a client-side button that runs the official /plan command, so nothing extra is required on any platform.

How it works

• Host (lib/index.js): no behavior — this is a pure UI plugin; the client half is discovered through the dsh.client declaration in package.json (exports["./client"]).
• Client (lib/client.js): registers the checklist icon button in the conversation.input.left seat using official DSW design tokens (follows dark/light theme); reads plan state live through useProjection("plan"); clicking executes the official /plan command via ctx.remote.commands.execute(sessionId, "/plan", []) — the whole flow stays on the official command chain.
• State handling: the effective plan state mirrors the official PlanChip algorithm (pending ? !active : active). While plan mode is active the button returns null (hidden — the official plan card owns the indicator, no duplicate); while a toggle is pending the button is disabled so a second click can't reverse the switch; command failures turn the button error-colored with the message in its tooltip.

Notes

• Pure client-side: no host routes, no file writes, no stored data.
• Restart dsh web after installing or updating (bundle layers are composed at startup); client-side edits apply on a page refresh.

Development

• Source: lib/index.js (host side, no-op), lib/client.js (web injection)
• Workflow: edit locally → push to main → pnpm update to verify the install

License

MIT