portless-local

Featured

Replace port numbers with stable named .localhost URLs for local development

AI & Automation 117 stars 13 forks Updated today MIT

Install

View on GitHub

Quality Score: 89/100

Stars 20%
69
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Portless - Named .localhost URLs Replace port numbers with stable, named `.localhost` URLs for local development. For humans and agents. > **Note:** By default, use HTTP (`http://myapp.localhost`). Only enable HTTPS (`--https` or `PORTLESS_HTTPS=1`) if the user specifically requests it (e.g., for OAuth, secure cookies, or HTTPS-only features). ## Why Portless? Local dev with port numbers is fragile. Portless fixes that by giving each dev server a stable, named `.localhost` URL. | Problem | With Ports | With Portless | | -------------------------- | ------------------------------------------------------- | ----------------------------------------------- | | **Port conflicts** | Two projects on :3000 = EADDRINUSE | Auto-assigned ports, named URLs - no collisions | | **Memorizing ports** | "Was the API on 3001 or 8080?" | Always `http://api.localhost` | | **Wrong app on refresh** | Stop one server, start another on same port = confusion | Named URLs eliminate this | | **Monorepo chaos** | Every service needs a unique port | Distinct hostnames for each service | | **Agent confusion** | AI agents guess/hardcode wrong ports | `http://myapp.localhost` is deterministic | | **Cookie/storage clashes** | Cookie...

Details

Author
jellydn
Repository
jellydn/my-ai-tools
Created
7 months ago
Last Updated
today
Language
Shell
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category