vercel-labs/portless

Health v2 · maintenance only

Adoption not part of the score

11327 stars · 369 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

A TypeScript CLI that replaces port numbers with stable, named .localhost URLs for local development, wrapping dev server commands behind an auto-started local proxy with HTTPS/HTTP2 by default. It targets both human developers and AI agents, with agent-readable Markdown docs and llms.txt.

Use cases

• access local dev server via a named https url instead of localhost:3000
• run next dev with a stable myapp.localhost domain
• give AI agents predictable local URLs for dev servers
• set up trusted local HTTPS certificates automatically
• proxy multiple local projects with custom TLDs
• auto-inject port flags for vite or astro dev scripts

When to choose

• you juggle many local dev servers and want memorable, stable URLs
• you need trusted local HTTPS with HTTP/2 and WebSocket support
• you want agents or scripts to reach dev servers via fixed hostnames
• you use frameworks that ignore the PORT env variable

When to avoid

• you need a production-grade reverse proxy or API gateway
• you require a fully stable 1.0 tool - it is pre-1.0 with changing state formats
• you only run a single simple dev server and don't mind port numbers

Facets

cli-tool · maturity active

proxy http-server developer-tools cli developer-tools web-development windows cli localhost local-development https reverse-proxy dev-server agent-friendly tls command-line automation macos linux nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="vercel-labs/portless")