porterminal

Gib einem Agenten einen Computer, volle Kontrolle, und schau ihm zu.
Ein Befehl, eine URL. (Außerdem ein schickes Terminal für dein eigenes Handy.)

1. uvx ptn
2. Gib die URL einem KI-Agenten, oder scanne den QR-Code selbst
3. Schau ihm in jedem Browser bei der Arbeit zu und übernimm jederzeit

[!WARNING] Diese vollständige URL bedeutet Vollzugriff auf diesen Computer. Sie enthält einen zufälligen Zugriffscode pro Start, und jeder (oder jeder KI-Agent), dem du sie gibst, erhält eine echte Shell auf deinem Rechner. Behandle die URL und den QR-Code wie ein Geheimnis, teile sie nur mit Personen und Agenten, denen du vertraust, und lies Sicherheit, bevor du Porterminal auf etwas Wichtiges richtest.

Warum

Ich brauche etwas gefährlich Einfaches, um aus der Ferne auf einen Computer zuzugreifen.

ngrok erfordert eine Registrierung und der kostenlose Tarif ist mies. Cloudflare Tunnel ist hervorragende Infrastruktur, liefert aber für sich genommen nur einen Tunnel, kein handyfreundliches Terminal. Tailscale ist großartig, wenn dir beide Enden gehören, bedeutet aber trotzdem, Geräte einem privaten Netzwerk hinzuzufügen. Termius erfordert eine komplizierte Einrichtung: Portweiterleitung, Firewall-Regeln, Schlüsselverwaltung...

Also habe ich etwas Einfacheres gebaut: einen Befehl ausführen, einen QR-Code scannen, anfangen zu tippen.

Dann machte es Klick: Derselbe Trick (ein Befehl, eine URL) ist der einfachste Weg, einem KI-Agenten ein echtes Terminal auf jedem Computer zu geben. Kein MCP-Server zu schreiben, keine SSH-Schlüssel, kein Docker, keine Konfiguration. Führe uvx ptn aus, übergib die URL, und der Agent führt Befehle aus, liest den Bildschirm und beantwortet Eingabeaufforderungen auf dieser Maschine. Und weil es ein Web-Terminal ist, kannst du dieselbe Sitzung in jedem Browser öffnen, um live zuzusehen, oder die Tastatur übernehmen.

Funktionen

• Gib einem Agenten einen Computer, volle Kontrolle, und schau ihm zu - Gib einem KI-Agenten die URL und er erhält ein echtes Terminal auf der Maschine über MCP oder einfaches REST. Öffne dieselbe Sitzung in jedem Browser, um live zuzusehen, und übernimm die Tastatur, wann immer du willst. Keine Schlüssel, kein Docker. Der Agent lernt, wie es geht, aus <url>/llms.txt und <url>/.well-known/mcp.json. Siehe Agentenzugriff.
• Ein Befehl, sofortiger Zugriff - uvx ptn und du (oder ein Agent) erhältst ein echtes Terminal auf dieser Maschine. Kein SSH, keine Portweiterleitung, keine Konfigurationsdateien. Cloudflare-Tunnel + QR-Code.
• Tatsächlich mobil nutzbar - Touch-optimiert mit Trägheitsscrolling, Pinch-to-Zoom, Wischgesten und Modifikatortasten (Ctrl, Alt).
• Vollwertige Terminal-Apps - vim, htop, less, tmux funktionieren alle korrekt mit richtiger Alt-Screen-Puffer-Behandlung.
• Persistente Multi-Tab-Sitzungen - Sitzungen überleben Verbindungsabbrüche. Schließe den Browser, wechsle das Netzwerk, verbinde dich von einem anderen Gerät neu, und deine Shell und laufenden Prozesse sind noch da. Du und ein Agent können sich eine Sitzung teilen: schau ihm zu oder übernimm.
• Plattformübergreifend - Windows (PowerShell, CMD, WSL), Linux/macOS (Bash, Zsh, Fish, Nushell und jede Shell über $SHELL). Erkennt deine Shells automatisch.
• Standardmäßig schwer zu erraten - Jeder Start fügt einen unabhängigen 128-Bit-Zufallszugriffspfad hinzu. Der bloße Tunnel-Hostname und jeder falsche Pfad liefern 404. Die URL wird auf dem Bildschirm verborgen, aber der QR-Code enthält die vollständige Anmeldeinformation, also halte beide geheim. Drücke c, um Agentenanweisungen und URL zu kopieren, u, um nur die URL zu kopieren, oder s, um die Agentenaufforderung auf dem Bildschirm anzuzeigen (q schließt sie).

Installation

Methode	Installation	Aktualisierung
uvx (keine 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

Einzeilige Installation (uv + ptn):

OS	Befehl
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

Erfordert Python 3.12+ und cloudflared (wird automatisch installiert, falls nicht vorhanden).

Verwendung

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

Flag	Beschreibung
-n, --no-tunnel	Nur lokales Netzwerk (kein Cloudflare-Tunnel)
--mcp-only	MCP-Shell-Steuerung ohne QR-Code, Browser-Terminal oder REST-API
-p, --password	Passwort abfragen, um diese Sitzung zu schützen
-sp, --save-password	Passwort in der Konfiguration speichern oder löschen
-tp, --toggle-password	Passwortanforderung festlegen (an/aus/umschalten)
-v, --verbose	Detaillierte Startprotokolle anzeigen
-i, --init	.ptn/ptn.yaml mit automatisch erkannten Projektskripten als Schaltflächen erstellen
-if, --init-from URL/PATH	.ptn/ptn.yaml aus einer URL oder lokalen Datei erstellen
-c, --compose	Compose-Modus standardmäßig aktivieren
-k, --keep-qr	QR-Code nach der ersten Verbindung sichtbar halten
-u, --check-update	Prüfen, ob eine neuere Version verfügbar ist
-V, --version	Version anzeigen

Während der Ausführung: Bei aktivem Tunnel wird die Verbindungs-URL aus Datenschutzgründen auf dem Bildschirm verborgen. Drücke c, um Agentenanweisungen und URL zu kopieren, einschließlich /mcp, /api/agent/run und /llms.txt; drücke u, um nur die URL zu kopieren; drücke s, um die vollständige Agentenaufforderung als auswählbaren Text anzuzeigen (q schließt sie); oder scanne den QR-Code, um dich zu verbinden. Ctrl+C stoppt den Server.

Agentenzugriff (MCP + REST)