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

…