एजेंट्स के लिए 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 टूल लौटाता है।
कॉन्ट्रैक्ट
- stdout पर JSON; stderr पर त्रुटियाँ और डायग्नोस्टिक्स; कभी मिश्रित नहीं।
- एग्ज़िट कोड: छह सिमैंटिक कोड जो usage, not-found, auth, conflict, क्षणिक विफलताओं और एक सामान्य फ़ॉलबैक को कवर करते हैं। पूरी तालिका CLI में देखें।
- म्यूटेशन फ़्लैग्स,
--body-file -(stdin) के ज़रिए JSON बॉडी, या दोनों से इनपुट लेते हैं; टकराव होने पर फ़्लैग जीतता है। --exampleएक वैध रिक्वेस्ट बॉडी प्रिंट करता है,--dry-runरिक्वेस्ट को भेजे बिना प्रीव्यू करता है, और--idempotency-keyफिर से प्रयास को सुरक्षित बनाता है।
अगले कदम
- अपना कोडिंग एजेंट सेटअप करें: एक प्रॉम्प्ट पेस्ट करें और आपका एजेंट CLI और स्किल्स इंस्टॉल कर देगा।
- एजेंट स्किल्स: हर स्किल आपके एजेंट को क्या सिखाती है।
- CLI रेफ़रेंस: हर कमांड, फ़्लैग और आउटपुट शेप।
- MCP सर्वर: MCP टूल्स जैसी ही Bird सरफ़ेस, उन एजेंट्स के लिए जो शेल चलाने की बजाय टूल्स कॉल करते हैं।
संबंधित संसाधन
इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।