Skip to content

v0.4.0 - Port Doctor: reclaim, stop-service, conflict-aware launch

Choose a tag to compare

@cspergel cspergel released this 18 Jun 19:13
· 23 commits to main since this release

AppShelf v0.4.0 — Port Doctor: reclaim, stop-service, conflict-aware launch

This release makes the Port Doctor actually resolve port problems, not just diagnose them — and stops AppShelf from silently launching into an occupied port.

New

  • Reclaim & Relaunch — when an orphaned port belongs to a registered app, one click stops the orphan, frees the port, and relaunches your app.
  • One-click Stop-Service (elevated) — service-backed ports now show a ⚙ Service badge and a Stop service button that does a proper SCM Stop-Service via a single UAC prompt (no more "access denied" dead-end). Detects service workers, not just direct services.exe children.
  • Pre-flight conflict check — launching an app whose port is held by another process now flags it: the card shows "port in use" and Start asks to reclaim (stop the other process and start your app) instead of silently opening the browser to the wrong server.
  • Owner-aware status — a registered port held by something AppShelf doesn't manage shows "port in use" rather than a misleading "running".
  • CLI appshelf doctor --json / --watch — scriptable port scans: clean JSON to stdout, an interval watch mode, and JSONL streaming with --json --watch.

Notes

  • Windows x64, self-contained — no .NET install required. Download AppShelf.exe below.
  • 225 unit tests, single-user personal tool.