skills.rest
tanaka-mambinge
tanaka-mambingeCOMMUNITY
Explore all skills by this author →
Website𝕏@iamt12eGitHub

portless

Replace port-based URLs with named .localhost endpoints for local development.

Updated Jan 2, 2026
Search Tags:#worktrees#local-development#localhost#https#subdomains#portless#dev-proxy
One-click install
npx skills add https://github.com/tanaka-mambinge/dotfiles --skill portless-tanaka-mambinge
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: portless
Source: https://github.com/tanaka-mambinge/dotfiles/tree/main/ai-configs/skills/portless
Command: npx skills add https://github.com/tanaka-mambinge/dotfiles --skill portless-tanaka-mambinge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Portless replaces port-based URLs with stable, named .localhost endpoints to keep local development deterministic and reduce context switching.

Core Features & Use Cases

  • Automatic generation of per-project subdomain URLs (e.g. https://myapp.localhost) and easy proxy configuration.
  • Support for multiple apps in monorepos, worktrees, and LAN scenarios with TLS options and host management.
  • Seamless integration into existing dev setups and straightforward workflows for rapid adoption.

Quick Start

Install portless globally or per-project, then run your app to automatically create a https://<name>.localhost URL.

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 subdomains for local development?▼

You can replace localhost port numbers with subdomains by using a dev-proxy that maps app names to assigned ports, generating stable .localhost endpoints for local development.

Can I use HTTPS with stable .localhost URLs in my monorepo?▼

Yes, the dev-proxy supports HTTPS for .localhost URLs by managing a local CA, and it handles multiple apps in monorepos with per-app subdomains automatically.

What is the best way to manage multiple local development URLs across worktrees?▼

To manage multiple local development URLs across worktrees, use a proxy that generates deterministic, named .localhost endpoints to reduce context switching between projects.

Do I need Node.js 20 to run a local proxy for .localhost subdomains?▼

Yes, you need Node.js 20 or higher to run the local proxy that manages subdomain URL generation, automatic proxy startup, and local CA configuration.

Does the local dev proxy support LAN configurations and TLS options?▼

Yes, the local dev proxy supports LAN scenarios with configurable TLS options and host management, allowing you to expose apps beyond localhost when needed.

Why are my local development ports causing context switching and how to fix it?▼

Local development ports cause context switching because they are unstable and hard to remember; fixing this requires mapping app names to assigned ports via stable .localhost URLs.

Related Skills

Explore More Software Engineering Skills→
tientt010tientt010

dotnet-devcert-trust

Diagnose and fix .NET HTTPS dev certificate trust issues on Linux.

Community
Advanced
kriegcloudkriegcloud
68

portless

Replace local development port numbers with named .localhost domains.

Community
Intermediate
ssv445ssv445
1

portless

Assign named .localhost URLs to local dev servers via a CLI proxy.

Community
Intermediate
ichuanichuan
1

deploy-caddy-reverse-proxy

Deploy Caddy reverse proxy with Let's Encrypt SSL and systemd integration.

Community
Advanced