Pular pro conteúdo

Portless skill

Cada projeto no seu computador ganha um endereço fixo com nome e HTTPS, e o Claude para de abrir a porta errada.

por Vercel LabsPublicada pela própria empresa

instalações
6.000
estrelas no GitHub
12,8 mil
No skills.sh desde
fevereiro de 2026
Licença
Apache-2.0

Atualizada no GitHub em 26 de outubro de 2026. Dados conferidos em 26 de outubro de 2026, no skills.sh e no GitHub.

O que ela faz

A skill ensina o agente a instalar e usar o portless, da Vercel Labs, que troca o número da porta por um endereço com nome. Em vez de localhost:3000, o site abre em https://meuapp.localhost. O portless sobe um proxy local, dá uma porta livre pro app e guarda a rota, então dois projetos não brigam mais pela mesma porta.

Funciona com Next.js, Vite, Astro, Expo e outros, e coloca a porta certa sozinho quando o framework ignora a variável PORT. Em monorepo, cada pacote ganha um subdomínio; em worktree do git, o nome da branch entra no endereço. O HTTPS vem ligado, com um certificado local que o sistema passa a aceitar.

Também compartilha o projeto: na mesma rede Wi-Fi, pela Tailscale, pelo ngrok ou por um túnel rápido da Cloudflare que não pede conta. Quando algo dá errado, o agente roda portless doctor e tem a correção pra Safari que não acha o endereço, certificado recusado e erros 502 e 508.

Nas palavras de quem fez

Set up and use portless for named local dev server URLs (e.g. https://myapp.localhost instead of http://localhost:3000). Use when integrating portless into a…

Vercel Labs, no SKILL.md

Quando usar

  • Rodar dois projetos ao mesmo tempo sem erro de porta ocupada
  • Mostrar pro cliente um site que ainda está só no seu computador
  • Ter HTTPS no ambiente local sem aviso de segurança no navegador
  • Trabalhar em várias branches com worktree, cada uma no seu endereço
  • Parar de perder tempo descobrindo em que porta o app subiu

Depois de instalar, é só pedir assim

  • Configura o portless nesse projeto pra ele abrir em https://minhaloja.localhost
  • Sobe o site com o portless e gera um link público pra eu mandar pro cliente ver
  • O endereço .localhost não abre no Safari, resolve isso

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

  • Gen Agent Trust HubPassou
  • SocketPassou
  • SnykPassou

Perguntas

Como instalar a Portless no Claude Code?

Toca em Levar, aqui nesta página, e deixa seu nome, e-mail e WhatsApp (é uma vez só). Aparece uma frase pronta: cola ela no Claude Code, que ele mesmo instala a Portless, e a skill passa a valer na próxima conversa. A mesma frase serve no Codex. Se preferir fazer na mão, o passo a passo está em como instalar skills no Claude Code.

O que a portless precisa pra funcionar?

Do Node.js 24 ou mais novo e do portless instalado pelo npm (npm install -g portless). Pra usar a porta 443 ele pede a senha de administrador no Mac e no Linux; sem ela, cai pra porta 1355. Não tem custo. Compartilhar pela Tailscale ou pelo ngrok pede essas ferramentas instaladas e com conta; o túnel da Cloudflare pede só o programa cloudflared.

Roda no Codex e no Antigravity?

Roda: a skill ensina comandos do portless no terminal, e o próprio portless foi pensado pra agentes pararem de testar a porta errada. Ele ainda tem um servidor MCP que lista rotas e endereços pra qualquer agente.

Ele coloca meu site no ar de verdade?

Não. O portless é pro ambiente de desenvolvimento. Os links públicos pela Tailscale Funnel, pelo ngrok ou pela Cloudflare caem quando o app para, e o da Cloudflare muda a cada vez que você roda.

Levar essa skill

1x portlessR$ 0,00

TotalR$ 0,00

A skill sai aqui mesmo, na hora. Seus dados eu uso pra falar com você sobre o MazyOS.

Levar precisa do JavaScript ligado. O código da skill está no GitHub: github.com/vercel-labs/portless

Aprenda a usar

Mais da loja Vercel Labs

Ver a loja Vercel Labs