Skip to content

v0.3.0 - Port Doctor ancestry traceback

Choose a tag to compare

@cspergel cspergel released this 18 Jun 01:17
· 27 commits to main since this release

AppShelf v0.3.0 — Port Doctor: process-ancestry traceback

The Port Doctor now explains why a port is stuck, not just that it is.

New

  • Process-ancestry traceback — expand any port row to see the full parent chain of the process holding it (e.g. node ← [dead] npm ← [dead] cmd), with each process's command line and exe directory pulled from WMI. Makes "why is this orphaned" obvious at a glance.
  • Copyable & selectable — a pinned Copy button copies the whole chain; the panel text is also drag-selectable for partial copies. Long chains scroll within the panel (no more jumping to the next row).
  • Service-aware kill — when a port is held by a Windows service (including a service's worker processes, detected via the Service Control Manager), AppShelf now says so and explains it needs elevation, instead of dumping a raw taskkill error.

Fixed

  • Ancestry walk now stops at the first dead ancestor instead of fabricating a bogus chain through recycled PIDs.
  • Kill failures surface a clean, readable message (no raw taskkill output).
  • Hardened the Ports panel refresh: crash-safe async scan and no dropped refresh after a kill.

Notes

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