dsh-auto-exit

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

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