Donnez n'importe quel ordinateur à votre agent

Une commande. Une URL. Un vrai terminal pour votre agent, une vue en direct pour vous.

Lancez Porterminal sur un ordinateur Windows, macOS ou Linux et donnez le lien généré à votre agent IA. Il obtient un vrai shell avec les fichiers, les outils et les projets présents sur cette machine. Ouvrez le même lien sur votre téléphone ou dans n'importe quel navigateur pour observer l'agent travailler et saisir du texte dans son terminal.

Commencez ici

Sur l'ordinateur que vous souhaitez donner à votre agent :

uvx ptn

1. Donnez le lien à l'agent. Appuyez sur c dans la fenêtre locale de Porterminal pour copier l'URL et les instructions de connexion. Collez-les dans votre agent avec une tâche. L'agent a besoin du support MCP distant ou d'un moyen d'effectuer des requêtes HTTP.
2. Ouvrez votre vue. Scannez le QR code ou ouvrez l'URL complète dans un navigateur. Sélectionnez l'onglet 🤖 de l'agent pour voir son terminal.
3. Travaillez ensemble. Observez la sortie, répondez à une invite interactive, tapez une commande, ou fermez l'onglet pour terminer ce shell.
4. Accédez à votre ordinateur depuis n'importe quel téléphone. Utilisez le navigateur de votre téléphone pour le vibe coding, des corrections rapides, l'exécution de commandes, et plus encore.

Pour démarrer dans un projet particulier, utilisez uvx ptn /path/to/project. Pour les options d'installation, consultez installation, ou utilisez un installateur ci-dessous.

Le lien est la clé de l'ordinateur. L'URL complète et le QR code accordent l'accès au shell. Ne les partagez qu'avec des personnes et des agents de confiance. Lire le modèle de sécurité.

L'agent travaille. Vous gardez le contrôle.

Votre agent	Vous
Exécute des commandes dans le shell réel de l'ordinateur	Observez la même sortie en direct dans un navigateur
Lit les écrans du terminal et répond aux invites	Tapez dans le même terminal lorsque nécessaire
Conserve l'état du shell entre les appels d'outils	Basculez entre les onglets de l'agent et les onglets personnels
Utilise MCP ou HTTP pour se connecter	Utilisez le QR code ou l'URL depuis un téléphone ou un ordinateur de bureau

La saisie du terminal est partagée ; coordonnez la frappe avec votre agent. Porterminal prend en charge les applications de terminal interactives, plusieurs onglets, et la reconnexion aux sessions en cours tant que le serveur et la session restent actifs.

L'interface mobile inclut les touches Ctrl/Alt/Shift, la sélection tactile, le défilement, le zoom par pincement, et un champ de composition pour éditer ou dicter une saisie plus longue. Consultez terminal controls.

Essayez la démo

Donnez à un agent un petit projet de facture avec une vérification en échec. Regardez-le trouver le bug, modifier le fichier, et faire passer les vérifications au vert. Répondez ensuite à l'invite de libellé du reçu depuis votre téléphone et faites lire le résultat à l'agent.

Le guide de démo inclut un projet prêt à copier, une tâche d'agent, et un plan d'enregistrement de 60 secondes. Il démontre les commandes, les modifications de fichiers, la vérification, et la saisie humaine dans une session partagée.

Connectez votre agent

Appuyer sur c copie les instructions pour les méthodes de connexion disponibles. Le serveur en cours d'exécution les sert également à l'adresse <url>/llms.txt.

Ici, <url> est l'URL complète générée, y compris son code d'accès.

Capacité de l'agent	Connexion
MCP distant	<url>/mcp — Streamable HTTP
Requêtes HTTP	<url>/api/agent/run — REST
Automatisation du navigateur	Ouvrez <url>/ ; utilisez Terminal screen et Terminal input

MCP expose quatre outils : run_command, read_screen, send_keys, et send_signal. REST renvoie un session_id que l'agent réutilise pour les commandes et interactions suivantes. Les shells de l'agent apparaissent comme onglets 🤖 dans votre navigateur.

Consultez agent access pour la configuration du client, des exemples de requêtes, les durées de vie des sessions, et les commandes de longue durée.

Installation

Nécessite Python 3.12+. Porterminal tente d'installer cloudflared automatiquement lorsqu'il est absent.

Méthode	Exécuter ou installer	Mettre à jour
uvx	uvx ptn	uvx --isolated 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

Installer uv et Porterminal ensemble :

Windows (PowerShell) :

powershell -ExecutionPolicy ByPass -c "irm https://raw.githubusercontent.com/porterminal/porterminal/master/install.ps1 | iex"

macOS / Linux :

curl -LsSf https://raw.githubusercontent.com/porterminal/porterminal/master/install.sh | sh

Utilisation

Après l'installation, exécutez ptn ou ptn /path/to/project.

Option	Objectif
--no-tunnel	Exécuter sans tunnel Cloudflare
--mcp-only	Exposer uniquement MCP ; désactive le QR code, le terminal navigateur et l'API REST
--compose	Démarrer avec le champ compose mobile activé
--init	Générer .ptn/ptn.yaml avec les boutons découverts à partir des scripts du projet
--password	Ajouter un mot de passe à l'accès au terminal navigateur
--help	Afficher toutes les options
--version	Afficher la version installée

Pendant l'exécution : c copie les instructions de l'agent, u copie uniquement l'URL, et s affiche le texte de partage à l'écran (q le ferme). Ctrl+C arrête Porterminal. En mode MCP uniquement, les touches de partage utilisent l'URL MCP.

Les shells personnalisés, les boutons de la barre d'outils et les paramètres de démarrage se trouvent dans ptn.yaml. Voir configuration.

Sécurité

Porterminal donne accès à un véritable shell avec les permissions de votre utilisateur. Le répertoire de départ est une commodité, pas un bac à sable ni une limite d'accès aux fichiers.