WHOSEPORT
Overview

What WhosePort is

An AI runtime engineer for local development. It observes your machine deterministically, investigates failures with evidence, proposes typed fixes you approve, and verifies the result.

The loop

Every investigation moves through the same stages. Deterministic collectors own the facts. The model owns the reasoning. Nothing mutates your machine without a policy check and, by default, your approval.

stages
Observe → Investigate → Diagnose → Approve → Act → Verify

Three surfaces, one engine

  • CLI. The primary surface. whoseport lists ports, whoseport 3000 inspects one, whoseport ask runs an investigation. Local, no account needed.
  • Dashboard. The environment graph, investigation history and approvals, shared with the members of your organization.
  • MCP server. Claude Code, Cursor and other MCP clients call read-only WhosePort tools and get structured evidence back.

First run

bash
$ bun add -g whoseport
$ whoseport

PORT PROCESS PROJECT SERVICE STATUS
3000 node ~/code/web Next.js ●
5432 postgres ~/code/platform PostgreSQL ●
8080 bun ~/code/gateway Elysia ●

Read-only until you say otherwise. See Action policy for exactly what can and cannot run.