harbormasterd
shipped · source ↗
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
2026-07-19 shippedv1.1.0 versionPython 3.9+ languageMIT licensepa · pa-platform · pad clis
Highlights
Zero-config HTTPSmkcert, Caddy CA, or self-signed fallback. Trust once, forget it.
*.pa.local DNSLocal resolver — no more /etc/hosts edits per project.
Port-conflict healingDetect collisions, auto-relocate, preserve preferred ranges.
Cross-platformWindows, macOS, Linux. Native UAC / sudo / systemd integration.
Stack
Python 3.9+ · mkcert · Caddy CA · SQLite · CLI · daemon
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.