In lokalen Stacks laufen Frontend, API, Auth, Docs und weitere Tools jeweils auf eigenen Ports. Spätestens mit mehreren parallel ausgeführten Projekten entstehen Portkonflikte und der Überblick geht verloren. Zudem ist die Portlogik für Tests und Agenten unhandlich: Sobald ein Dienst auf einen anderen Port wechselt, stimmen gespeicherte URLs nicht mehr und automatisierte Abläufe brechen ab.

Das Open-Source-CLI-Tool portless aus den Vercel Labs ersetzt klassische Portnummern wie localhost:3000 durch stabile, sprechende .localhost-Domains wie https://erp.localhost und verwaltet lokale Ports. Das ist nicht nur für Menschen nützlich, sondern auch für KI-Agenten, die Anwendungen so leichter finden und ansteuern können. portless wrappt bestehende dev-Kommandos wie npm run dev oder pnpm dev und leitet den Traffic über einen lokalen Reverse-Proxy mit benannten .localhost-URLs. Statt dass ein Framework direkt an Port 3000 oder 5173 gebunden ist, weist portless dem Prozess im Hintergrund über die Umgebungsvariable PORT einen zufälligen Port zu (standardmäßig im Bereich 4000 bis 4999).

Parallel registriert portless ein Mapping von Hostnamen zu diesem Port in einem lokalen Zustand, der das Mapping speichert – beispielsweise das Mapping myapp.localhost zu localhost:4309 – und routet alle Anfragen an https://myapp.localhost transparent zu dieser gemappten Anwendung. Die Portnummer ist damit ein Implementierungsdetail, mit dem Entwicklerinnen und Entwickler im Alltag nicht mehr interagieren müssen.

Das war die Leseprobe unseres heise-Plus-Artikels "Wie portless lokales Entwickeln vereinfacht". Mit einem heise-Plus-Abo können Sie den ganzen Artikel lesen.