porterminal v1.0.6
Tunneling terminal web/mcp rapide et sale entre votre téléphone & votre pc
Confiez un ordinateur à un agent, avec un contrôle total, et regardez-le travailler.
Une commande, une URL. (Aussi un terminal élégant pour votre propre téléphone.)
1. uvx ptn
2. Confiez l'URL à un agent IA, ou scannez le QR vous-même
3. Regardez-le travailler dans n'importe quel navigateur, et reprenez la main à tout moment
[!WARNING] Cette URL complète donne un accès total à cet ordinateur. Elle contient un code d'accès aléatoire propre à chaque lancement, et quiconque (ou n'importe quel agent IA) à qui vous la confiez obtient un véritable shell sur votre machine. Traitez l'URL et le QR code comme un secret, ne les partagez qu'avec des personnes et des agents de confiance, et lisez la section Sécurité avant de pointer Porterminal vers quoi que ce soit d'important.
Pourquoi
J'avais besoin de quelque chose de dangereusement simple pour accéder à distance à un ordinateur.
ngrok exige une inscription et son offre gratuite est médiocre. Cloudflare Tunnel est une excellente plomberie, mais à lui seul il ne fournit qu'un tunnel, pas un terminal adapté au téléphone. Tailscale est parfait quand vous possédez les deux extrémités, mais cela implique quand même de joindre les appareils à un réseau privé. Termius exige une configuration compliquée : redirection de ports, règles de pare-feu, gestion des clés...
J'ai donc construit quelque chose de plus simple : lancez une commande, scannez un QR, commencez à taper.
Puis j'ai compris : le même tour de passe-passe (une commande, une URL) est la façon la plus simple de donner à un agent IA un véritable terminal sur n'importe quel ordinateur. Pas de serveur MCP à écrire, pas de clés SSH, pas de Docker, pas de configuration. Lancez uvx ptn, transmettez l'URL, et l'agent exécute des commandes, lit l'écran et répond aux invites sur cette machine. Et comme c'est un terminal web, vous pouvez ouvrir la même session dans n'importe quel navigateur pour le regarder travailler en direct, ou prendre le clavier et reprendre la main.
Fonctionnalités
- Confiez un ordinateur à un agent, avec un contrôle total, et regardez-le travailler - Donnez l'URL à un agent IA et il obtient un véritable terminal sur la machine via MCP ou REST simple. Ouvrez la même session dans n'importe quel navigateur pour le regarder travailler en direct, et prenez le clavier quand vous le souhaitez. Pas de clés, pas de Docker. L'agent apprend comment faire à partir de
<url>/llms.txtet<url>/.well-known/mcp.json. Voir Accès agent. - Une commande, accès instantané -
uvx ptnet vous (ou un agent) obtenez un véritable terminal sur cette machine. Pas de SSH, pas de redirection de ports, pas de fichiers de configuration. Tunnel Cloudflare + QR code. - Vraiment utilisable sur mobile - Optimisé pour le tactile avec défilement inertiel, zoom par pincement, gestes de balayage et touches modificatrices (Ctrl, Alt).
- Applications terminal complètes - vim, htop, less, tmux fonctionnent tous correctement avec une gestion adéquate du tampon d'écran alternatif.
- Sessions multi-onglets persistantes - Les sessions survivent aux déconnexions. Fermez le navigateur, changez de réseau, reconnectez-vous depuis un autre appareil, et votre shell et vos processus en cours sont toujours là. Vous et un agent pouvez partager une session : regardez-le travailler, ou reprenez la main.
- Multiplateforme - Windows (PowerShell, CMD, WSL), Linux/macOS (Bash, Zsh, Fish, Nushell, et n'importe quel shell via
$SHELL). Détecte automatiquement vos shells. - Difficile à deviner par défaut - Chaque lancement ajoute un chemin d'accès aléatoire indépendant de 128 bits. Le nom d'hôte du tunnel nu et tout chemin erroné renvoient 404. L'URL est masquée à l'écran, mais le QR contient l'identifiant complet, alors gardez les deux privés. Appuyez sur
cpour copier les instructions de l'agent et l'URL, ou surupour copier uniquement l'URL.
Installation
| Méthode | Installation | Mise à jour |
|---|---|---|
| uvx (sans installation) | 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 |
Installation en une ligne (uv + ptn) :
| OS | Commande |
|---|---|
| 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 |
Nécessite Python 3.12+ et cloudflared (installé automatiquement si absent).
Utilisation
ptn # Start in current directory
ptn ~/projects/myapp # Start in specific folder
| Option | Description |
|---|---|
-n, --no-tunnel | Réseau local uniquement (pas de tunnel Cloudflare) |
--mcp-only | Contrôle du shell via MCP sans QR code, terminal navigateur ni API REST |
-p, --password | Demander un mot de passe pour protéger cette session |
-sp, --save-password | Enregistrer ou effacer le mot de passe dans la configuration |
-tp, --toggle-password | Définir l'exigence de mot de passe (on/off/bascule) |
-v, --verbose | Afficher les journaux de démarrage détaillés |
-i, --init | Créer .ptn/ptn.yaml avec les scripts de projet auto-découverts comme boutons |
-if, --init-from URL/PATH | Créer .ptn/ptn.yaml à partir d'une URL ou d'un fichier local |
-c, --compose | Activer le mode composition par défaut |
-k, --keep-qr | Garder le QR code visible après la première connexion |
-u, --check-update | Vérifier si une version plus récente est disponible |
-V, --version | Afficher la version |
Pendant l'exécution : avec un tunnel actif, l'URL de connexion est masquée à l'écran pour des raisons de confidentialité. Appuyez sur c pour copier les instructions de l'agent et l'URL, y compris /mcp, /api/agent/run et /llms.txt ; appuyez sur u pour copier uniquement l'URL ; ou scannez le QR pour vous connecter. Ctrl+C arrête le serveur.