porterminal v1.0.6
Tunneling terminale web/mcp veloce e sporco per telefono e PC
Consegna un computer a un agente, pieno controllo, e guardalo lavorare.
Un comando, un URL. (Anche un terminale elegante per il tuo telefono.)
1. uvx ptn
2. Consegna l'URL a un agente AI, oppure scansiona tu stesso il QR
3. Guardalo lavorare in qualsiasi browser, e prendi il controllo in qualsiasi momento
[!WARNING] Quell'URL completo è accesso completo a questo computer. Contiene un codice di accesso casuale per ogni avvio, e chiunque (o qualsiasi agente AI) a cui lo consegni ottiene una shell reale sulla tua macchina. Tratta l'URL e il codice QR come un segreto, condividili solo con persone e agenti di cui ti fidi, e leggi Sicurezza prima di puntare Porterminal verso qualcosa di importante.
Perché
Ho bisogno di qualcosa di pericolosamente semplice per accedere da remoto a un computer.
ngrok richiede la registrazione e il piano gratuito fa schifo. Cloudflare Tunnel è un'ottima infrastruttura, ma da sola fornisce solo un tunnel, non un terminale adatto al telefono. Tailscale è ottimo quando possiedi entrambe le estremità, ma significa comunque aggiungere dispositivi a una rete privata. Termius richiede una configurazione complicata: port forwarding, regole del firewall, gestione delle chiavi...
Così ho costruito qualcosa di più semplice: esegui un comando, scansiona un QR, inizia a digitare.
Poi ho capito: lo stesso trucco (un comando, un URL) è il modo più semplice per dare a un agente AI un terminale reale su qualsiasi computer. Nessun server MCP da scrivere, nessuna chiave SSH, nessun Docker, nessuna configurazione. Esegui uvx ptn, consegna l'URL, e l'agente esegue comandi, legge lo schermo e risponde ai prompt su quella macchina. E poiché è un terminale web, puoi aprire la stessa sessione in qualsiasi browser per guardarlo lavorare dal vivo, oppure prendere la tastiera e subentrare.
Funzionalità
- Consegna un computer a un agente, pieno controllo, e guardalo lavorare - Dai a un agente AI l'URL e ottiene un terminale reale sulla macchina tramite MCP o semplice REST. Apri la stessa sessione in qualsiasi browser per guardarlo lavorare dal vivo, e prendi la tastiera quando vuoi. Nessuna chiave, nessun Docker. L'agente impara come fare da
<url>/llms.txte<url>/.well-known/mcp.json. Vedi Accesso agente. - Un comando, accesso istantaneo -
uvx ptne tu (o un agente) ottenete un terminale reale su questa macchina. Niente SSH, niente port forwarding, niente file di configurazione. Tunnel Cloudflare + codice QR. - Davvero utilizzabile su mobile - Ottimizzato per il tocco con scorrimento con inerzia, pinch-to-zoom, gesture di swipe e tasti modificatori (Ctrl, Alt).
- Applicazioni terminale complete - vim, htop, less, tmux funzionano tutti correttamente con una corretta gestione del buffer alt-screen.
- Sessioni multi-tab persistenti - Le sessioni sopravvivono alle disconnessioni. Chiudi il browser, cambia rete, riconnettiti da un altro dispositivo, e la tua shell e i processi in esecuzione sono ancora lì. Tu e un agente potete condividere una sessione: guardalo lavorare, oppure subentra.
- Multipiattaforma - Windows (PowerShell, CMD, WSL), Linux/macOS (Bash, Zsh, Fish, Nushell, e qualsiasi shell tramite
$SHELL). Rileva automaticamente le tue shell. - Difficile da indovinare per impostazione predefinita - Ogni avvio aggiunge un percorso di accesso casuale indipendente a 128 bit. Il semplice hostname del tunnel e ogni percorso errato restituiscono 404. L'URL è nascosto sullo schermo, ma il QR contiene la credenziale completa, quindi mantieni entrambi privati. Premi
cper copiare le istruzioni per l'agente e l'URL, oppureuper copiare solo l'URL.
Installazione
| Metodo | Installazione | Aggiornamento |
|---|---|---|
| uvx (nessuna installazione) | 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 |
Installazione in una riga (uv + ptn):
| OS | 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 |
Richiede Python 3.12+ e cloudflared (installato automaticamente se mancante).
Utilizzo
ptn # Start in current directory
ptn ~/projects/myapp # Start in specific folder
| Flag | Descrizione |
|---|---|
-n, --no-tunnel | Solo rete locale (nessun tunnel Cloudflare) |
--mcp-only | Controllo shell MCP senza codice QR, terminale browser o API REST |
-p, --password | Richiedi una password per proteggere questa sessione |
-sp, --save-password | Salva o cancella la password nella configurazione |
-tp, --toggle-password | Imposta il requisito della password (on/off/toggle) |
-v, --verbose | Mostra log di avvio dettagliati |
-i, --init | Crea .ptn/ptn.yaml con gli script di progetto rilevati automaticamente come pulsanti |
-if, --init-from URL/PATH | Crea .ptn/ptn.yaml da un URL o file locale |
-c, --compose | Abilita la modalità compose per impostazione predefinita |
-k, --keep-qr | Mantieni il codice QR visibile dopo la prima connessione |
-u, --check-update | Verifica se è disponibile una versione più recente |
-V, --version | Mostra la versione |
Durante l'esecuzione: con un tunnel attivo, l'URL di connessione è nascosto sullo schermo per privacy. Premi c per copiare le istruzioni per l'agente e l'URL, inclusi /mcp, /api/agent/run e /llms.txt; premi u per copiare solo l'URL; oppure scansiona il QR per connetterti. Ctrl+C arresta il server.