WHOSEPORT
Investigations · guide

Stale process

A process that survived your restart, or a server from another worktree still holding the port.

Ask

bash
whoseport 8080

What WhosePort checks

  • The process on the port, its start time and parent chain
  • Its cwd, project and Git worktree
  • Whether the server you meant to start is running at all

Typical root cause

An older dev server still holds the port, so the new one crashed or picked another port.

Proposed fix

  • stop_process on the old PID (approval required)
Approval
Every step that changes your machine is a typed action classed by the policy engine. It waits for your approval in the dashboard, which shows the target, risk and expected effect first. A changed .env file is backed up before it is written. See /docs/policy.

Verification

  • Port is free, or the new process owns it
  • It answers over HTTP