porterminal v1.0.6

Entrega un ordenador a un agente, control total, y míralo trabajar.
Un comando, una URL. (También un terminal elegante para tu propio teléfono.)

1. uvx ptn
2. Entrega la URL a un agente de IA, o escanea el QR tú mismo
3. Míralo trabajar en cualquier navegador, y toma el control cuando quieras

[!WARNING] Esa URL completa es acceso total a este ordenador. Contiene un código de acceso aleatorio por lanzamiento, y cualquiera (o cualquier agente de IA) a quien se la entregues obtiene un shell real en tu máquina. Trata la URL y el código QR como un secreto, compártelos solo con personas y agentes de confianza, y lee Seguridad antes de apuntar Porterminal a algo importante.

Por qué

Necesito algo peligrosamente fácil para acceder remotamente a un ordenador.

ngrok requiere registro y el plan gratuito es malo. Cloudflare Tunnel es una infraestructura excelente, pero por sí solo solo te da un túnel, no un terminal cómodo para el teléfono. Tailscale es genial cuando controlas ambos extremos, pero sigue implicando unir dispositivos a una red privada. Termius requiere una configuración complicada: reenvío de puertos, reglas de firewall, gestión de claves...

Así que construí algo más simple: ejecuta un comando, escanea un QR, empieza a escribir.

Y entonces lo entendí: el mismo truco (un comando, una URL) es la forma más fácil de darle a un agente de IA un terminal real en cualquier ordenador. Sin servidor MCP que escribir, sin claves SSH, sin Docker, sin configuración. Ejecuta uvx ptn, entrega la URL, y el agente ejecuta comandos, lee la pantalla y responde a los prompts en esa máquina. Y como es un terminal web, puedes abrir la misma sesión en cualquier navegador para verlo trabajar en directo, o tomar el teclado y hacerse cargo.

Características

• Entrega un ordenador a un agente, control total, y míralo trabajar - Dale a un agente de IA la URL y obtiene un terminal real en la máquina vía MCP o REST simple. Abre la misma sesión en cualquier navegador para verlo trabajar en directo, y toma el teclado cuando quieras. Sin claves, sin Docker. El agente aprende cómo hacerlo desde <url>/llms.txt y <url>/.well-known/mcp.json. Consulta Acceso de agentes.
• Un comando, acceso instantáneo - uvx ptn y tú (o un agente) obtienes un terminal real en esta máquina. Sin SSH, sin reenvío de puertos, sin archivos de configuración. Túnel de Cloudflare + código QR.
• Realmente usable en móvil - Optimizado para táctil con desplazamiento con inercia, zoom con pinza, gestos de deslizamiento y teclas modificadoras (Ctrl, Alt).
• Aplicaciones de terminal completas - vim, htop, less, tmux funcionan correctamente con un manejo adecuado del búfer de pantalla alternativa.
• Sesiones multi-pestaña persistentes - Las sesiones sobreviven a las desconexiones. Cierra el navegador, cambia de red, reconéctate desde otro dispositivo, y tu shell y procesos en ejecución siguen ahí. Tú y un agente podéis compartir una sesión: míralo trabajar, o toma el control.
• Multiplataforma - Windows (PowerShell, CMD, WSL), Linux/macOS (Bash, Zsh, Fish, Nushell, y cualquier shell vía $SHELL). Detecta tus shells automáticamente.
• Difícil de adivinar por defecto - Cada lanzamiento añade una ruta de acceso aleatoria independiente de 128 bits. El nombre de host del túnel sin más y cualquier ruta incorrecta devuelven 404. La URL se oculta en pantalla, pero el QR contiene la credencial completa, así que mantén ambos en privado. Pulsa c para copiar las instrucciones del agente y la URL, o u para copiar solo la URL.

Instalación

Método	Instalar	Actualizar
uvx (sin instalación)	uvx ptn	uvx ptn@latest
uv tool	uv tool install ptn	uv tool upgrade ptn
pipx	pipx install ptn	pipx upgrade ptn
pip	pip install ptn	pip install -U ptn

Instalación en una línea (uv + ptn):

SO	Comando
Windows	powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/lyehe/porterminal/master/install.ps1 | iex"
macOS/Linux	curl -LsSf https://raw.githubusercontent.com/lyehe/porterminal/master/install.sh | sh

Requiere Python 3.12+ y cloudflared (se instala automáticamente si falta).

Uso

ptn                    # Start in current directory
ptn ~/projects/myapp   # Start in specific folder

Flag	Descripción
-n, --no-tunnel	Solo red local (sin túnel de Cloudflare)
--mcp-only	Control de shell MCP sin código QR, terminal de navegador ni API REST
-p, --password	Solicitar contraseña para proteger esta sesión
-sp, --save-password	Guardar o borrar la contraseña en la configuración
-tp, --toggle-password	Establecer el requisito de contraseña (on/off/toggle)
-v, --verbose	Mostrar registros de inicio detallados
-i, --init	Crear .ptn/ptn.yaml con scripts de proyecto autodescubiertos como botones
-if, --init-from URL/PATH	Crear .ptn/ptn.yaml desde una URL o archivo local
-c, --compose	Habilitar el modo compose por defecto
-k, --keep-qr	Mantener el código QR visible tras la primera conexión
-u, --check-update	Comprobar si hay una versión más reciente disponible
-V, --version	Mostrar la versión

Mientras se ejecuta: con un túnel activo, la URL de conexión se oculta en pantalla por privacidad. Pulsa c para copiar las instrucciones del agente y la URL, incluyendo /mcp, /api/agent/run y /llms.txt; pulsa u para copiar solo la URL; o escanea el QR para conectarte. Ctrl+C detiene el servidor.

Acceso de agentes (MCP + REST)