Kill the process on a port and verify the port becomes available. Port-only targets. Asks for confirmation unless --yes.

proc free :3000            # free port 3000
proc free :3000,:8080      # free multiple ports
proc free :3000 --wait 30  # wait up to 30s for port to free

Options

Flag Short Description
--yes -y Skip confirmation
--dry-run   Show what would be freed
--wait <secs>   Seconds to wait for port availability (default: 10)
--json -j Output as JSON
--verbose -v Show extra details

Examples

# free a single port
proc free :3000

# free multiple ports without confirmation
proc free :3000,:8080 --yes

# wait longer for port to become available
proc free :3000 --wait 30

# preview before freeing
proc free :3000 --dry-run

See also

kill for force kill without port verification, stop for graceful shutdown, on to check what’s on a port.