portless

Replace local port numbers with stable named .localhost domains.

10.4k|338|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/vercel-labs/portless --skill portless-vercel-labs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: portless
Source: https://github.com/vercel-labs/portless/tree/main/skills/portless
Command: npx skills add https://github.com/vercel-labs/portless --skill portless-vercel-labs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill replaces hard-to-remember local port numbers with stable, named .localhost URLs, preventing port conflicts and simplifying local development for individuals and AI agents.

Core Features & Use Cases

  • Named Localhost URLs: Access your local development servers via URLs like http://myapp.localhost:1355 instead of http://localhost:3000.
  • Automatic Proxy Management: The portless proxy starts automatically when needed and handles routing.
  • Subdomain Support: Organize multiple services with subdomains (e.g., api.myapp.localhost).
  • Git Worktree Integration: Automatically assigns unique URLs to different Git worktrees based on branch names.
  • HTTPS/HTTP/2 Support: Enables faster, more secure local development with automatic certificate generation.

Quick Start

Install portless globally and then run your development server using portless run next dev.

Frequently Asked Questions about portless

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I replace localhost port numbers with named local dev URLs?

You can replace hard-to-remember localhost port numbers with stable, named `.localhost` URLs by running your development server through a proxy, such as executing `portless run next dev` to route traffic automatically.

What is the best way to manage local development server port conflicts?

Managing local development server port conflicts is best handled by using a proxy to assign stable, named `.localhost` domains to each service, preventing cross-project collisions and eliminating manual port memorization.

Can I use subdomains to organize multiple local development services?

Yes, you can use subdomains like `api.myapp.localhost` to organize multiple local development services, allowing the proxy to route traffic to the correct local ports without manual configuration.

Does local development proxy management support HTTPS and HTTP/2?

Local development proxy management supports HTTPS and HTTP/2 by generating automatic certificates, enabling faster and more secure local development environments through the configured `.localhost` URLs.

How do I assign unique local URLs to different Git worktrees?

You can assign unique local URLs to different Git worktrees through automatic proxy integration, which maps stable `.localhost` domains based on your specific branch names for isolated development.