deepseekplugins

DeepSeek Harness plugin

dsh-web-restart-csdjl88

DSH web plugin: one-click full process restart of the harness from the sidebar — terminates the current `dsh web` process and relaunches the identical command via a startup guard (no daemon

Security & Permissions
Jump to install

Source facts

Repository
csdjl88/dsh-web-restart
Latest update
Aug 21, 2026
Category
Security & Permissions
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-21

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/csdjl88/dsh-web-restart
Plugin: dsh-web-restart-csdjl88
Author: csdjl88

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer4 files
README.mdSource · read only
README language

dsh-web-restart

English | 中文

DSH web plugin: one-click full restart of the harness from the sidebar — terminates the current dsh web process and relaunches the identical command through a startup guard (no systemd/Docker supervisor required), with automatic page recovery and an agent-callable restart tool.

> The npm name dsh-restart is already taken by a same-purpose project, so this plugin ships as dsh-web-restart.

Features

  • 🔘 Sidebar restart button in the sidebar.footer.action row (beside the Cordis lifecycle panel). Click = restart, no confirmation dialog (single-user, trusted-host model).
  • ♻️ Full process restart: terminates the current dsh web process and relaunches the same command line (preserving --profile / --patch and all inner flags, always ensuring --no-open so no browser window is popped).
  • 🛡️ Startup guard (no daemon needed): the fresh process is launched only after the old process has exited AND the web port is free, eliminating the port-races that would otherwise crash boot (DSH's webserver binds on startup and has no EADDRINUSE retry).
  • 🔄 No page reload, no new tab: while restarting, the button shows "Restarting…" and polls the health endpoint; the page stays put and DSH's WebSocket auto-reconnect (connection/reset) restores the UI in the same session tab (the session survives via DSH persistence).
  • 🧰 Agent-callable tool dsh_restart sharing the same restart core.
  • 🌐 Bilingual (zh/en) UI copy and README.
  • 🚫 Single-flight guard: duplicate clicks/tool calls while a restart is in flight are rejected.

Install

dsh plugin --profile web add github:csdjl88/dsh-web-restart

Restart DSH for the button to appear in the sidebar footer.

Usage

Web button

Click "Restart DSH" at the bottom of the sidebar. The button shows "Restarting…" and polls automatically; the page does not reload — DSH's WebSocket auto-reconnect restores the UI in the same session tab (no new tab). If the fresh process is not ready within 30 seconds, an error is shown (check the terminal running dsh).

Agent tool

Just ask "restart DSH" in a conversation (tool dsh_restart, optional reason argument). Note: a restart interrupts all running agent tasks and background jobs.

How it works

click / tool call
   └─ POST /dsh-restart (idempotent, single-flight)
        └─ spawn the relaunch guard (same node + original argv + auto `--no-open`)
             └─ old process exits after ~1s
                  └─ guard polls: old pid gone & port free
                       └─ relaunch `dsh web` (with `--no-open`) in its own session
                            └─ no reload, no new tab — DSH auto-reconnects to the same session tab
  • The relaunch command always carries --no-open (appended when the original command lacks it): the browser is already in front of the user, so no new window is popped.
  • No full-page reload: DSH's WebSocket auto-reconnect (connection/reset) restores the UI in the original session tab.
  • HTTP endpoints: POST /dsh-restart (trigger), GET /dsh-restart/health (liveness; returns pid so the front end can recognise the fresh process).
  • Env contract: DSH_RESTARTED_BY / DSH_RESTART_OLD_PID / DSH_RESTART_PORT.

Stopping a restarted DSH (important)

After a restart the fresh dsh web runs in its own session (process group). The original dsh was the terminal's foreground process-group leader; once it dies the old group becomes orphaned and no longer receives the terminal's Ctrl+C — this is inherent to the Unix process model and cannot be fixed by the plugin. Stop the restarted harness with any of:

  • Close the terminal window running dsh (the guard detects the terminal closing and terminates the harness; the port is released) — recommended.
  • Press Ctrl+D in the terminal (also a terminal-close signal).
  • Or, in a new terminal: pkill -f "dsh web" / kill <pid> (lsof -iTCP:3080 to find the pid).

Compatibility

  • Designed for running dsh web in a foreground terminal (no supervisor); the relaunch pipeline is verified against a real dsh web instance.
  • ⚠️ Use with caution under a supervisor that has an auto-restart policy (systemd / Docker / pm2): when the old process exits, BOTH the supervisor and this plugin's guard may relaunch it, producing two instances racing for the port (one crashes with EADDRINUSE). In a supervised environment, disable the supervisor's restart policy or remove this plugin.
  • Requires DSH 0.1.0-rc.7 or newer.

Development

npm run check   # syntax checks
npm test        # unit tests + process-level e2e (real restart pipeline)

License

MIT

Back to searchOpen GitHub repository

More related plugins

View category