porterminal v1.2.0
Schnelles und unkompliziertes Web/MCP-Terminal-Tunneling für Handy & PC
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.txtund<url>/.well-known/mcp.json. Siehe Agentenzugriff. - Ein Befehl, sofortiger Zugriff -
uvx ptnund 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, oders, um die Agentenaufforderung auf dem Bildschirm anzuzeigen (qschließ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.