एजेंटों के लिए CLI
bird CLI एक ही बाइनरी है, जिसे एजेंट द्वारा चलाए जाने के लिए बनाया गया है। आउटपुट डिफ़ॉल्ट रूप से JSON होता है, त्रुटियाँ stderr पर जाती हैं और एग्ज़िट कोड विफलता की श्रेणी बताते हैं।
सेटअप करें
सबसे तेज़ तरीका है अपना कोडिंग एजेंट सेट अप करना: एक प्रॉम्प्ट पेस्ट करें और आपका एजेंट आपके लिए CLI और Bird की स्किल्स इंस्टॉल कर देता है। इसे मैन्युअल रूप से इंस्टॉल करने के लिए:
curl -fsSL https://cli.bird.com/install.sh | sh
bird auth loginbird auth login ब्राउज़र में OAuth फ़्लो चलाता है और आपके वर्कस्पेस व उसके क्षेत्र से जुड़ा एक ग्रांट सहेजता है, इसलिए आपको API कुंजी या होस्ट कॉन्फ़िगर नहीं करना पड़ता। bird auth status हमेशा 0 के साथ बाहर निकलता है और टोकन काम करने पर valid: true रिपोर्ट करता है। bird whoami साइन-इन किए गए उपयोगकर्ता (ID, ईमेल और नाम) को लौटाता है। एजेंट इसी पहचान से काम करता है, और MCP whoami टूल भी यही पहचान लौटाता है।
अनुबंध
- JSON stdout पर जाता है; त्रुटियाँ और डायग्नोस्टिक्स stderr पर जाते हैं; दोनों कभी मिलते नहीं।
- एग्ज़िट कोड: छह अर्थपूर्ण कोड, जो उपयोग, नहीं मिला, ऑथ, टकराव, अस्थायी विफलताओं और एक सामान्य फ़ॉलबैक को कवर करते हैं। पूरी तालिका CLI में देखें।
- बदलाव करने वाले कमांड इनपुट फ़्लैग से,
--body-file -(stdin) के ज़रिए JSON बॉडी से, या दोनों से लेते हैं; दोनों होने पर फ़्लैग को प्राथमिकता मिलती है। --exampleएक मान्य अनुरोध बॉडी प्रिंट करता है,--dry-runअनुरोध भेजे बिना उसका पूर्वावलोकन दिखाता है, और--idempotency-keyफिर से प्रयास को सुरक्षित बनाता है।
अगले चरण
- अपना कोडिंग एजेंट सेट अप करें: एक प्रॉम्प्ट पेस्ट करें और आपका एजेंट CLI और स्किल्स इंस्टॉल कर देगा।
- एजेंट स्किल्स: हर स्किल आपके एजेंट को क्या सिखाती है।
- CLI संदर्भ: हर कमांड, फ़्लैग और आउटपुट का स्वरूप।
- MCP सर्वर: वही Bird सतह MCP टूल्स के रूप में, उन एजेंटों के लिए जो शेल चलाने के बजाय टूल्स कॉल करते हैं।
संबंधित संसाधन
इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।