The field guide

A small workbench for your machine#

PortPilot brings local listeners, Unix-socket daemons, established connections and scheduled cron jobs into view. The macOS app, command line and terminal UI share a Swift core.

01 / SET UP

Use the command line ↗

Find listeners and understand their owners.

03 / GET ORIENTED

Explore the app ↗

Ports, observations, schedules and themes.

04 / BUILD

Work on the source ↗

Targets, commands and project structure.

Choose your surface#

macOS app: A menu-bar view and full workspace for inspecting local activity.
CLI · portpilot: Small commands, port ranges and JSON output for scripts.
TUI · portpilot-tui: A full terminal interface. Install the TUI alongside the CLI to use portpilot tui.

Platform notes#

The macOS app requires macOS 13 or later. CLI/TUI source requires Swift 5.9 or later. Selected Linux and WSL paths exist; native Windows support is experimental and has not been validated for feature or security parity.