@phaseo/cli इंस्टॉल करें और phaseo login चलाएँ। CLI मॉडल, प्रदाता, कीमतें, क्रेडिट, गतिविधि, एनालिटिक्स और जनरेशन भी पढ़ता है।
इंस्टॉल करें
नया वर्ज़न प्रकाशित होने पर इंटरैक्टिव रन एक संकेत भी दिखाते हैं।
साइन इन करें
रिमोट और गैर-इंटरैक्टिव एनवायरनमेंट अपने आप डिवाइस कोड इस्तेमाल करते हैं। आप किस खाते से साइन इन हैं, अपने स्कोप, सक्रिय वर्कस्पेस और दूसरे वर्कस्पेस के साथ देखें:
अपना वर्कस्पेस प्रबंधित करें
--json इस्तेमाल करें। CLI रोज़मर्रा के खाता कामों को कवर करता है; कुंजियों की सीमाएँ, बजट, BYOK, रूटिंग नियम, प्रीसेट और पहचान डैशबोर्ड में या प्रबंधन कुंजी से बदले जाते हैं। CLI कौन-से काम कवर करता है, यह एजेंट से Phaseo प्रबंधित करें में देखें।
कोडिंग एजेंट जोड़ें
एजेंट का नाम कमांड के रूप में इस्तेमाल करें। CLI एक समर्पित कुंजी का अनुरोध करता है, जिसे आप ब्राउज़र में स्वीकृत करते हैं, और एजेंट का कॉन्फ़िगरेशन लिखता है:--model, --catalog all|default या --dry-run इस्तेमाल करें। phaseo setup <agent> और phaseo integrations setup <agent> भी काम करते हैं।
ब्राउज़र में कुंजी स्वीकृत करें
किसी एजेंट को पहली बार सेट अप करने पर CLI Phaseo डैशबोर्ड का एक पेज खोलता है और उसका लिंक दिखाता है। पेज पर वर्कस्पेस, कुंजी का नाम, उसकी $100 मासिक खर्च सीमा और 90 दिन की समाप्ति, और यह दिखता है कि Phaseo CLI ने उसका अनुरोध किया है। स्वीकृत करें और कुंजी बनाएं चुनें, तो CLI कुंजी को एक बार ले लेता है और सेटअप पूरा करता है। अस्वीकार करें चुनें, या अनुरोध को 10 मिनट में समाप्त होने दें, तो कुछ भी नहीं बनता। डैशबोर्ड में उसी खाते से साइन इन रहकर स्वीकृत करें जिसका उपयोग आपने CLI में किया था, वर्कस्पेस के मालिक या एडमिन के रूप में, और अगर आपने दूसरा फ़ैक्टर सेट किया है तो उसके साथ। SSH या CI में, दिखाया गया लिंक किसी भी ऐसे डिवाइस पर खोलें जिस पर आप साइन इन हैं। डैशबोर्ड में बनाई गई कुंजी का उपयोग करने के लिए उसे--key <key> से दें, या शेल हिस्ट्री से बाहर रखने के लिए --key-stdin से। CLI कुंजी को जांचकर सहेजता है, और एजेंट हटाने पर उसे रद्द नहीं करता।
Cline, Kilo Code, oh-my-pi, Muse Code या MiniMax Code को ऐसी अस्थायी सेटिंग्स के साथ चलाने के लिए जो उनके बंद होने पर मिट जाएँ, सत्र रनर इस्तेमाल करें। Phaseo के फ़्लैग -- से पहले, और एजेंट के अपने फ़्लैग उसके बाद लिखें:
phaseo run <cline|kilo|omp|muse|minimax> लंबा रूप है। हर सक्रिय Phaseo टेक्स्ट मॉडल दिखाने के लिए --catalog all जोड़ें, या कुंजी बनाए बिना पूर्वावलोकन के लिए --dry-run --json। इंटरैक्टिव टर्मिनल में रनर गायब एजेंट को इंस्टॉल करने का विकल्प देते हैं (Windows पर MiniMax Code अपना आधिकारिक PowerShell इंस्टॉलर इस्तेमाल करता है; Windows पर Muse Code हाथ से इंस्टॉल करना होता है)। जब आप एजेंट ख़ुद संभालते हैं, तो --skip-install इस्तेमाल करें।
कोडिंग एजेंट हर एजेंट, उसकी कमांड क्या करती है, और उसकी गाइड की सूची देता है।
CLI से स्क्रिप्ट लिखें
--json वाली कमांड बिना रंग या स्पिनर के सादा संरचित आउटपुट प्रिंट करती हैं। बाकी जगहों पर स्पिनर stderr पर जाते हैं और काम पूरा होने पर अपनी लाइन साफ़ कर देते हैं।
CLI क्रेडेंशियल कैसे सुरक्षित रखता है
- सत्र OS क्रेडेंशियल स्टोर में रखे जाते हैं।
PHASEO_SESSION_BACKEND=fileसिर्फ़ तभी सेट करें जब कोई क्रेडेंशियल स्टोर उपलब्ध न हो; यह रिफ़्रेश टोकन को सीमित अनुमतियों वाली सादा-टेक्स्ट फ़ाइल में रखता है। phaseo logoutलोकल स्थिति साफ़ करने से पहले सेव किया गया रिफ़्रेश टोकन रद्द करता है।- प्रबंधन कुंजियों को स्पष्ट क्षमताएँ चाहिए। इनफ़रेंस कुंजियाँ स्कोप की जगह गार्डरेल, रूटिंग नीतियों और वर्कस्पेस सेटिंग्स से सीमित होती हैं।
OAuth ऐप
Phaseo CLI, उपयोगकर्ताओं के बनाए ऐप और डायनामिक रूप से रजिस्टर किए गए MCP क्लाइंट के लिए एक ही OAuth ऑथराइज़ेशन सर्वर इस्तेमाल करता है। CLI रोटेट होने वाले रिफ़्रेश टोकन के साथ ब्राउज़र या डिवाइस लॉगिन इस्तेमाल करता है। तीसरे पक्ष के क्लाइंट PKCE के साथ ऑथराइज़ेशन कोड, स्पष्ट स्कोप और वर्कस्पेस सहमति, और वैकल्पिक protected-resource बाइंडिंग इस्तेमाल करते हैं। उन्हें 7 दिन चलने वाला रद्द करने योग्य एक्सेस टोकन और आख़िरी इस्तेमाल से 90 दिन चलने वाला रोटेट होने वाला रिफ़्रेश टोकन मिलता है; रिफ़्रेश कैसे काम करता है, इसके लिए OAuth Next.js वर्कबेंच बनाएँ देखें। उसी ऐप को फिर से मंज़ूरी देने पर दूसरी कुंजी जोड़ने की जगह उसकी कुंजी नवीनीकृत होती है। होस्ट किए गए Phaseo API में तीसरे पक्ष का OAuth चालू है। सेल्फ़-होस्टेड और प्रीव्यू API डिप्लॉयमेंट में यह बंद रहता है, जब तकPHASEO_THIRD_PARTY_OAUTH_ENABLED सत्य मान न हो: 1, true, yes या on, बड़े-छोटे अक्षरों का फ़र्क़ नहीं, और आसपास के स्पेस अनदेखे किए जाते हैं।
.env