porterminal v1.0.6

एक एजेंट को कंप्यूटर सौंपें, पूरा नियंत्रण दें, और उसे काम करते देखें।
एक कमांड, एक 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 दबाएँ।

इंस्टॉल

तरीका	इंस्टॉल	अपडेट
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                    # Start in current directory
ptn ~/projects/myapp   # Start in specific folder

फ़्लैग	विवरण
-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 दबाएँ; या कनेक्ट करने के लिए QR स्कैन करें। Ctrl+C सर्वर बंद कर देता है।

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

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

वही URL AI एजेंटों के लिए भी काम करता है। MCP-सक्षम क्लाइंट नेटिव टाइप्ड टूल्स के लिए <url>/mcp (Streamable HTTP) इस्तेमाल कर सकते हैं। जो एजेंट MCP सर्वर रजिस्टर नहीं कर सकते, वे साधारण HTTP रिक्वेस्ट के साथ <url>/api/agent/run पर REST फ़ॉलबैक इस्तेमाल कर सकते हैं। दोनों में से कोई भी रास्ता एक पर्सिस्टेंट एजेंट शेल बनाता है, जो 🤖 टैब के रूप में दिखता है जिसे आप अपने फ़ोन से देख और नियंत्रित कर सकते हैं।