portopsy is a powerful command-line interface (CLI) tool designed for Linux and WSL2 environments. It provides a readable and interactive way to identify which processes are using specific network ports, especially when dealing with port conflicts like EADDRINUSE.
- Inspect Process Trees: Easily view the entire process tree, including the parent process chain, for any process occupying a port.
- Working Directory and Executable Path: Get detailed information about the working directory and the full path to the executable of the process.
- Container Integration: Understand if a port is being used by a process within a Docker, Podman, or systemd cgroup.
- Safe Resolver: The tool includes a guarded resolver that revalidates PIDs, prompts for confirmation before taking action, and sends SIGTERM signals gracefully.
- Multiple Installation Options: Install portopsy via a system shell script, Homebrew, GitHub Releases (for .deb packages), or build directly from source using Cargo.
- Read-only by Default: Operates in a safe, read-only mode by default, with interactive prompts for any potentially disruptive actions.
- Interactive TUI and JSON Output: Offers both a user-friendly Text-based User Interface (TUI) and JSON output formats for flexibility in usage.
portopsy helps developers and system administrators quickly diagnose and resolve port conflicts without accidentally stopping critical services.