portopsy_

LINUX / WSL2 · RUST-POWERED

Who is actually using port 3000?

Inspect process trees, working directories, container cgroups, and safe actions in a single command.

$curl -sSfL https://raw.githubusercontent.com/pratyush2514/portopsy/main/install.sh | sudo sh

Read-only by default.

Interactive TUI
portopsy / demo.gifportopsy :3000
portopsy inspecting a port and displaying its diagnostic followed by JSON output

The recording shows both views in sequence.

What it finds

Socket to decision.

Socket Metadata

Protocol, local address, state, inode, and UID from the Linux socket tables.

Process Tree & CWD

PID, full command, executable path, working directory, and parent process chain.

Container Cgroups

Docker, Podman, and systemd details read from the owning process cgroup.

Guarded Resolver

Revalidate the PID, show the action, require yes, then send SIGTERM first.

Install

Install anywhere.

System Shell

binary installer

01
$curl -sSfL https://raw.githubusercontent.com/pratyush2514/portopsy/main/install.sh | sudo sh

Installs to /usr/local/bin

Homebrew Tap

macOS / Linux

02
$brew install pratyush2514/tap/portopsy

Install through Homebrew

Debian / Ubuntu

GitHub Releases

03
$curl -sLO https://github.com/pratyush2514/portopsy/releases/latest/download/portopsy_amd64.deb && sudo dpkg -i portopsy_amd64.deb

Download the latest .deb

Cargo

from source

04
$cargo install --git https://github.com/pratyush2514/portopsy

Build with Rust