shipped/projects/tools/oss
harbormasterd
Zero-thinking port management with automatic HTTPS and DNS for local development. Three CLIs (pa, pa-platform, pad), local resolver for *.pa.local, mkcert-backed certs.
At a glance
shipped
2026-07-19
version
v1.1.0
language
Python 3.9+
license
MIT
clis
pa · pa-platform · pad
Highlights
Zero-config HTTPS
mkcert, Caddy CA, or self-signed fallback. Trust once, forget it.
*.pa.local DNS
Local resolver — no more /etc/hosts edits per project.
Port-conflict healing
Detect collisions, auto-relocate, preserve preferred ranges.
Cross-platform
Windows, macOS, Linux. Native UAC / sudo / systemd integration.
Stack
Python 3.9+mkcertCaddy CASQLiteCLIdaemon
Picked harbormasterd as the ship name after the port-authority proposal hit a PyPI collision — American spelling plus Unix d suffix to land cleanly on the registry.
Three CLIs ship in the box:
pa— daily dev.pa run,pa reserve,pa release,pa who,pa scan,pa doctor,pa events.pa-platform— HTTPS + DNS setup, team-shared contexts.pad— long-running daemon.
Most users only need pa. Use pa-platform for one-time setup and team configurations.
Quick start
pip install -r requirements.txt
pad &
pa selftest
pa tls trust
pa dns install
pa run --name=myapp --prefer=3000 python app.py
# → https://myapp.pa.local (automatic HTTPS)Source and install instructions on GitHub. MIT, pip-installable. 12 test categories across 9 platform combinations.