porterminal v1.0.7

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. Transmettez l'URL à un agent IA, ou scannez le QR code 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 toute personne (ou tout agent IA) à qui vous la transmettez 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 à un ordinateur à distance.

ngrok exige une inscription et l'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 contrôlez les deux extrémités, mais cela implique quand même de joindre les appareils à un réseau privé. Termius nécessite 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 code, 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.txt et <url>/.well-known/mcp.json. Voir Accès agent.
• Une commande, accès instantané - uvx ptn et 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 correctement avec une gestion appropriée 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 incorrect renvoient 404. L'URL est masquée à l'écran, mais le QR code contient l'identifiant complet, alors gardez les deux privés. Appuyez sur c pour copier les instructions de l'agent et l'URL, u pour copier uniquement l'URL, ou s pour afficher l'invite de l'agent à l'écran (q la ferme).

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 du 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