Show HN: Proc-CLI – An agent-friendly CLI tool for process and port management

Proc-CLI is a cross-platform command-line tool for managing processes and network ports on macOS, Linux, and Windows. Its central idea is to make common tasks expressible with consistent, guessable commands rather than combinations of system utilities and shell pipelines. Targets can be specified by port, PID, process name or command line, file, or project folder. For example, users can identify what is listening on a port, inspect its details, trace its parent processes to discover what launched it, or see which ports a process holds. Folder filters help limit actions to a particular project, while combined targets allow several processes or ports to be handled together.

The tool also supports listing process trees, finding orphaned processes left behind by closed terminals, detecting CPU-heavy processes that may be stuck, and monitoring processes or waiting for them to exit. Actions range from graceful shutdown to immediate termination, freeing ports, pausing and resuming processes, and attempting recovery from a stuck state. Destructive commands show what they will affect and ask for confirmation; dry-run previews changes, while JSON output is available for scripts and automation. The pitch is that Proc-CLI brings discovery, diagnosis, and cleanup into one consistent interface, reducing the need to remember commands such as lsof, ps, and kill or to pipe their outputs together.