# Instrucciones para el agente: Portless: nombres estables para tus aplicaciones locales

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: principiante
- Proyecto: https://github.com/vercel-labs/portless (licencia Apache-2.0)
- Guía completa: https://lab.wisd.ai/hub/portless-named-urls

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Preparación

Comprueba Node.js ≥24 y npm, como exige el [paquete publicado](https://github.com/vercel-labs/portless/blob/main/packages/portless/package.json). Abre la carpeta de una aplicación Next.js con sus dependencias ya instaladas antes de ejecutar el ejemplo.

### Paso 1: instala

```bash
npm install -g portless
```

### Paso 2: inicia una aplicación

El ejemplo del README supone un proyecto Next.js:

```bash
portless myapp next dev
```

Si tu proyecto tiene otro servidor, consulta los ejemplos oficiales antes de cambiar su comando.

## Comprobación

Abre https://myapp.localhost y confirma que muestra tu aplicación. Comprueba que los recursos y las conexiones del servidor de desarrollo funcionan.

## Si algo falla

Si hay un problema de certificado, revisa la sección de confianza local. Para HTTP simple, el README documenta `--no-tls`. Si no se asigna el puerto correcto, comprueba cómo interpreta Portless tu script.