WHOSEPORT
Start

Install the CLI

One command-line tool that includes the local agent and the MCP server. macOS and Linux. No account needed for local use.

Early access
WhosePort is in early access. The command below is how the CLI installs; the package opens to everyone at launch.

Requirements

NeedWhy
Bun 1.3 or newerThe CLI and agent run on Bun.
macOS or LinuxPorts come from lsof on macOS and ss on Linux. Windows is not supported yet.
Docker (optional)Container state and logs, read through the Docker socket.
Git (optional)Branch, worktree and changed-file names for each project.

Install

bash
$ bun add -g whoseport

Check it works

bash
$ whoseport doctor

WHOSEPORT DOCTOR

✓ platform darwin arm64
✓ bun 1.4.2
✓ lsof available
✓ ps 584 processes visible
✓ git
✓ docker engine API reachable (2 containers)
! cloud not connected
What the CLI reads
Listening sockets, process metadata, Docker through its socket, Git metadata in project folders, HTTP responses from local services, and the variable names and host/port targets in project .env files. It has no general file-read tool and uploads nothing unless you connect the dashboard.

Connect the dashboard (optional)

Create an environment in the dashboard and generate an agent token. The environment page shows the exact commands, including your token and the API address:

bash
$ whoseport agent connect wpa_… --api-url https://whoseport.com
$ whoseport agent start

The agent talks to the cloud over HTTPS. Every 10 seconds it sends a heartbeat, plus a redacted snapshot when something changed, and it long-polls for investigation requests. It never opens a port to the internet, and the cloud cannot reach your machine except through those typed requests. See Redaction for what leaves your machine.