PortPilot
PortPilot is a reusable Rust toolkit and CLI for managing local ports and processes:
Find it. Inspect it. Kill it.
Install
Library
CLI (from source)
Quickstart (library)
use ;
CLI commands
Example portpilot.toml:
[[]]
= "postgres"
[[]]
= "redis"
Images and default ports come from catalog.toml (a catalog.toml in the current directory overrides the built-in one):
[[]]
= "redis"
= "redis:latest"
= 6379
dev up / dev down start/stop each service as Docker container portpilot-<name>.
kill asks for confirmation. If the number is both a listening port and a PID it refuses to guess; pass --port or --pid.
Design notes
- Library-first API for reuse in other tools.
- CLI is a thin wrapper (
src/bin/portpilot.rs) with confirmation UX forkill. - Public API is semver-oriented:
list_ports,find_by_port,find_by_process,inspect_pid,terminate.
Feature coverage
- Library-first API for reuse in other tools.
- Public API is semver-oriented:
list_ports,find_by_port,find_by_process,inspect_pid,terminate. - CLI is a thin wrapper (
src/bin/portpilot.rs) with confirmation UX forkill. - CPU/Memory: included in
list,process,port, andinspectoutput. - Interactive TUI:
portpilot watchwith navigation, inspect shortcut, and explicit kill confirmation. - Dev services:
portpilot devreadsportpilot.toml(auto-creates an empty service list) and reports running/stopped status by port.
Testing
For local smoke tests:
For automated cross-platform validation, CI matrix is included at:
/.github/workflows/cross-platform-ci.yml
It runs on:
macos-latestubuntu-latestwindows-latest