porterminal

किसी एजेंट को एक कंप्यूटर सौंपें, पूरा नियंत्रण दें, और उसे काम करते देखें।
एक कमांड, एक URL। (आपके अपने फ़ोन के लिए भी एक शानदार टर्मिनल।)

1. uvx ptn
2. URL किसी AI एजेंट को सौंपें, या खुद QR स्कैन करें
3. किसी भी ब्राउज़र में इसे काम करते देखें, और कभी भी नियंत्रण अपने हाथ में लें

[!WARNING] वह पूरा URL इस कंप्यूटर तक पूरी पहुँच है। इसमें हर लॉन्च के लिए एक रैंडम एक्सेस कोड होता है, और जिसे भी आप यह देते हैं (कोई भी व्यक्ति या कोई AI एजेंट) उसे आपकी मशीन पर असली शेल मिल जाता है। URL और QR कोड को एक रहस्य की तरह मानें, इन्हें केवल उन्हीं लोगों और एजेंटों के साथ साझा करें जिन पर आप भरोसा करते हैं, और Porterminal को किसी महत्वपूर्ण चीज़ पर इस्तेमाल करने से पहले Security पढ़ें।

क्यों

मुझे किसी कंप्यूटर तक खतरनाक रूप से आसान रिमोट एक्सेस चाहिए।

ngrok के लिए रजिस्ट्रेशन चाहिए और उसका फ्री टियर बेकार है। Cloudflare Tunnel बेहतरीन प्लंबिंग है, लेकिन अकेले यह सिर्फ एक टनल देता है, फ़ोन-फ्रेंडली टर्मिनल नहीं। Tailscale तब शानदार है जब दोनों सिरे आपके पास हों, लेकिन फिर भी इसका मतलब है डिवाइसों को एक प्राइवेट नेटवर्क से जोड़ना। Termius के लिए जटिल सेटअप चाहिए: पोर्ट फ़ॉरवर्डिंग, फ़ायरवॉल नियम, की मैनेजमेंट...

तो मैंने कुछ आसान बनाया: एक कमांड चलाएँ, QR स्कैन करें, टाइप करना शुरू करें।

फिर समझ आया: वही तरकीब (एक कमांड, एक URL) किसी AI एजेंट को किसी भी कंप्यूटर पर असली टर्मिनल देने का सबसे आसान तरीका है। न कोई MCP सर्वर लिखना, न SSH कीज़, न Docker, न कॉन्फ़िग। uvx ptn चलाएँ, URL सौंपें, और एजेंट उस मशीन पर कमांड चलाता है, स्क्रीन पढ़ता है, और प्रॉम्प्ट का जवाब देता है। और चूँकि यह एक वेब टर्मिनल है, आप उसी सेशन को किसी भी ब्राउज़र में खोलकर इसे लाइव काम करते देख सकते हैं, या कीबोर्ड पकड़कर नियंत्रण अपने हाथ में ले सकते हैं।

विशेषताएँ

• किसी एजेंट को एक कंप्यूटर सौंपें, पूरा नियंत्रण दें, और उसे काम करते देखें - किसी AI एजेंट को URL दें और उसे MCP या सादे REST के ज़रिए मशीन पर असली टर्मिनल मिल जाता है। उसी सेशन को किसी भी ब्राउज़र में खोलकर इसे लाइव काम करते देखें, और जब चाहें कीबोर्ड पकड़ लें। न कीज़, न Docker। एजेंट <url>/llms.txt और <url>/.well-known/mcp.json से तरीका सीखता है। देखें Agent access।
• एक कमांड, तुरंत पहुँच - uvx ptn और आपको (या किसी एजेंट को) इस मशीन पर असली टर्मिनल मिल जाता है। न SSH, न पोर्ट फ़ॉरवर्डिंग, न कॉन्फ़िग फ़ाइलें। Cloudflare टनल + QR कोड।
• मोबाइल पर वाकई उपयोगी - टच-अनुकूलित, मोमेंटम स्क्रॉलिंग, पिंच-टू-ज़ूम, स्वाइप जेस्चर, और मॉडिफ़ायर कीज़ (Ctrl, Alt) के साथ।
• पूर्ण टर्मिनल ऐप्स - vim, htop, less, tmux सब सही तरीके से काम करते हैं, उचित alt-screen बफ़र हैंडलिंग के साथ।
• स्थायी मल्टी-टैब सेशन - सेशन डिस्कनेक्ट के बाद भी बने रहते हैं। ब्राउज़र बंद करें, नेटवर्क बदलें, किसी दूसरे डिवाइस से दोबारा कनेक्ट करें, और आपका शेल और चल रही प्रक्रियाएँ अब भी वहीं हैं। आप और एक एजेंट एक सेशन साझा कर सकते हैं: इसे काम करते देखें, या नियंत्रण ले लें।
• क्रॉस-प्लेटफ़ॉर्म - Windows (PowerShell, CMD, WSL), Linux/macOS (Bash, Zsh, Fish, Nushell, और $SHELL के ज़रिए कोई भी शेल)। आपके शेल्स को ऑटो-डिटेक्ट करता है।
• डिफ़ॉल्ट रूप से अनुमान लगाना मुश्किल - हर लॉन्च एक स्वतंत्र 128-बिट रैंडम एक्सेस पाथ जोड़ता है। बेयर टनल होस्टनेम और हर गलत पाथ 404 लौटाते हैं। URL स्क्रीन पर छिपा रहता है, लेकिन QR में पूरा क्रेडेंशियल होता है, इसलिए दोनों को निजी रखें। एजेंट निर्देश और URL कॉपी करने के लिए c दबाएँ, केवल URL कॉपी करने के लिए u, या एजेंट प्रॉम्प्ट स्क्रीन पर दिखाने के लिए s दबाएँ (q इसे बंद करता है)।

इंस्टॉल

तरीका	इंस्टॉल	अपडेट
uvx (बिना इंस्टॉल)	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

वन-लाइन इंस्टॉल (uv + ptn):

OS	कमांड
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

Python 3.12+ और cloudflared चाहिए (गायब होने पर ऑटो-इंस्टॉल हो जाता है)।

उपयोग

ptn                    # वर्तमान डायरेक्टरी में शुरू करें
ptn ~/projects/myapp   # किसी विशिष्ट फ़ोल्डर में शुरू करें

फ़्लैग	विवरण
-n, --no-tunnel	केवल लोकल नेटवर्क (कोई Cloudflare टनल नहीं)
--mcp-only	बिना QR कोड, ब्राउज़र टर्मिनल, या REST API के MCP शेल नियंत्रण
-p, --password	इस सेशन की सुरक्षा के लिए पासवर्ड माँगें
-sp, --save-password	कॉन्फ़िग में पासवर्ड सहेजें या हटाएँ
-tp, --toggle-password	पासवर्ड आवश्यकता सेट करें (on/off/toggle)
-v, --verbose	विस्तृत स्टार्टअप लॉग दिखाएँ
-i, --init	ऑटो-डिस्कवर किए गए प्रोजेक्ट स्क्रिप्ट्स को बटन के रूप में .ptn/ptn.yaml बनाएँ
-if, --init-from URL/PATH	किसी URL या लोकल फ़ाइल से .ptn/ptn.yaml बनाएँ
-c, --compose	डिफ़ॉल्ट रूप से compose मोड सक्षम करें
-k, --keep-qr	पहले कनेक्शन के बाद QR कोड दिखाई देता रखें
-u, --check-update	जाँचें कि कोई नया संस्करण उपलब्ध है या नहीं
-V, --version	संस्करण दिखाएँ

चलते समय: टनल सक्रिय होने पर, गोपनीयता के लिए कनेक्शन URL स्क्रीन पर छिपा रहता है। एजेंट निर्देश और URL कॉपी करने के लिए c दबाएँ, जिसमें /mcp, /api/agent/run, और /llms.txt शामिल हैं; केवल URL कॉपी करने के लिए u दबाएँ; पूरा एजेंट प्रॉम्प्ट चयन-योग्य टेक्स्ट के रूप में दिखाने के लिए s दबाएँ (q इसे बंद करता है); या कनेक्ट करने के लिए QR स्कैन करें। Ctrl+C सर्वर बंद करता है।

एजेंट एक्सेस (MCP + REST)

पूरी तरह पर्दे के पीछे शेल नियंत्रण के लिए, ptn --mcp-only चलाएँ। लोकल टर्मिनल UI खुला रहता है: एजेंट प्रॉम्प्ट और MCP पता कॉपी करने के लिए c दबाएँ, केवल MCP पता कॉपी करने के लिए u, या प्रॉम्प्ट स्क्रीन पर दिखाने के लिए s दबाएँ (q इसे बंद करता है)। ये कीज़ --no-tunnel के साथ भी काम करती हैं। अपने MCP क्लाइंट को जनरेट किए गए <url>/mcp एंडपॉइंट से कनेक्ट करें। यह मोड कोई QR कोड नहीं दिखाता और वेब टर्मिनल, ब्राउज़र WebSockets, और REST API को अक्षम कर देता है, इसलिए कमांड ब्राउज़र के ज़रिए देखे या दर्ज नहीं किए जा सकते। MCP डिस्कवरी और /llms.txt उपलब्ध रहते हैं। पूरा MCP URL अब भी कंप्यूटर का शेल नियंत्रण प्रदान करता है।