DeepSeek Harness Plugin

xiaxingtianxia2-glitch/dsh-auto-exit

Stars ★ 1 Downloads (30d) 349 Category Development & Runtime Added 2026-08-18 npm dsh-auto-exit

Exits the dsh CLI process automatically when the Web UI closes, with a configurable grace period and dry-run mode.

Install

# from npm (prebuilt)

dsh plugin --profile web add dsh-auto-exit

# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)

dsh plugin --profile web add github:xiaxingtianxia2-glitch/dsh-auto-exit

Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).

README

English | 中文

What is this?

dsh --profile web keeps a long-running process in your terminal, driven from a browser Web UI. This plugin makes closing the Web UI equivalent to exiting the process: once every page is closed, the CLI process exits automatically through the same graceful shutdown path as Ctrl+C (exit code 130) — no need to go back to the terminal.

How it works

  1. Detection — the browser page keeps WebSocket connections to the CLI process; closing the page drops them.
  2. Grace period — after all connections are lost, it waits 15 seconds (configurable) before exiting, so a quick refresh or reopen never kills the process; reopening the page cancels the exit.
  3. Exit — when the grace period expires, it uses the same graceful shutdown channel as Ctrl+C and the process ends with exit code 130, saving state as usual.

Install

dsh plugin --profile web add dsh-auto-exit

Or from the GitHub source (identical content):

dsh plugin --profile web add github:xiaxingtianxia2-glitch/dsh-auto-exit

Usage

  1. Start dsh --profile web and open the Web UI in your browser (default http://127.0.0.1:3080).
  2. Close the browser tab(s)/window(s) (all of them if you have several).
  3. The process exits automatically 15 seconds later.

Check status

curl http://127.0.0.1:3080/auto-exit/status

{"enabled":true,"armed":true,"sockets":2,"countdownMs":0,"graceSeconds":15,"pollMs":1000,"dryRun":false,"lastEvent":"armed","fired":false}

Field meanings: sockets — current page connections; countdownMs — remaining countdown (0 = not counting down); lastEvent — latest state change (idle/armed/lost/cancel/exit).

Configuration

Field Default Description
enabled true Master switch
graceSeconds 15 Seconds to wait after all connections are lost before exiting
pollMs 1000 Poll interval (ms)
armAfterFirstConnect true Only arm after the first page connects (a freshly started server with no browser open does not exit)
dryRun false Dry run: only log "would exit", never actually exit

FAQ

  • Why hasn't it exited yet? Other tabs/windows are still open — the countdown only starts once all connections are gone.
  • Does it exit on laptop sleep or browser crash? Yes — a dropped connection means the UI is no longer usable; increase graceSeconds if you don't want that.
  • How do I turn it off temporarily? Set enabled to false, or uninstall: dsh plugin --profile web remove dsh-auto-exit.

License

MIT

Content from the project README on GitHub ↗

Links

GitHub repository ↗ npm package ↗ Install via dsh-market ↗

More in this category

View the whole category →

Community comments

Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.