इस प्रोजेक्ट के बारे में

lark-cli लार्क/फ़िशू के लिए आधिकारिक कमांड-लाइन इंटरफ़ेस है, जिसे larksuite टीम द्वारा बनाए रखा जाता है। इसे मानव उपयोगकर्ताओं और AI एजेंटों दोनों के लिए बनाया गया है, जिसमें Messenger, Docs, Base, Sheets, Slides, Calendar, Mail, Tasks, Meetings, Markdown, Wiki, Contact, Attendance, Approval, OKR, Project और Apps सहित 18 मुख्य व्यावसायिक डोमेन शामिल हैं, साथ ही 200 से अधिक क्यूरेटेड कमांड और 26 AI Agent Skills हैं। इस टूल में agent-native डिज़ाइन है, जिसमें संरचित Skills लोकप्रिय AI टूल्स के साथ संगत हैं, जिससे Agents बिना किसी अतिरिक्त सेटअप के Lark को संचालित कर सकते हैं। हर कमांड को वास्तविक Agents के साथ परीक्षण किया गया है, जिसमें संक्षिप्त पैरामीटर, स्मार्ट डिफ़ॉल्ट और संरचित आउटपुट शामिल हैं ताकि Agent कॉल सफलता दर अधिकतम हो सके। यह MIT लाइसेंस के तहत ओपन सोर्स है और इसे कुछ ही चरणों में npm के माध्यम से इंस्टॉल किया जा सकता है। तीन-स्तरीय कमांड प्रणाली विभिन्न ग्रैन्युलैरिटी पर लचीलापन प्रदान करती है: Shortcuts (+ उपसर्ग के साथ, मानव और AI दोनों के लिए स्मार्ट डिफ़ॉल्ट और तालिका आउटपुट के साथ डिज़ाइन किए गए), API Commands (Lark OAPI मेटाडेटा से स्वतः उत्पन्न, मूल्यांकन और गुणवत्ता गेट्स के माध्यम से क्यूरेटेड, जिनमें 100+ कमांड प्लेटफ़ॉर्म एंडपॉइंट्स के 1:1 मैप किए गए हैं), और Raw API Calls (किसी भी Lark Open Platform एंडपॉइंट तक सीधी पहुँच, 2500+ APIs कवर करते हुए)। प्रमाणीकरण इंटरैक्टिव चयन या स्कोप के लिए CLI फ़्लैग के साथ OAuth लॉगिन, उपयोगकर्ता और bot के बीच पहचान स्विचिंग, और गैर-ब्लॉकिंग सत्यापन URL के साथ agent mode का समर्थन करता है। टूल में कई आउटपुट प्रारूप (JSON, pretty, table, ndjson, CSV), पेजिनेशन समर्थन, साइड-इफेक्ट कमांड के लिए dry-run पूर्वावलोकन, और API पैरामीटर और प्रतिक्रिया संरचनाओं के निरीक्षण के लिए schema introspection शामिल है। सुरक्षा सुविधाओं में input injection सुरक्षा, टर्मिनल आउटपुट स्वच्छता, OS-नेटिव keychain क्रेडेंशियल स्टोरेज, और आधिकारिक Feishu/Lark HTTPS डोमेन पर OpenAPI अनुरोधों के साथ भेजे गए risk-control सिग्नल शामिल हैं। टूल उपयोगकर्ताओं को AI Agents द्वारा स्वचालित संचालन में निहित जोखिमों के बारे में चेतावनी देता है, जिसमें मॉडल हैल्यूसिनेशन, अप्रत्याशित निष्पादन और prompt injection शामिल हैं, और समूह चैट के बजाय एक निजी संवादी सहायक के रूप में एकीकृत bot का उपयोग करने की सलाह देता है। एंटरप्राइज़ उपयोग के लिए, टूल केंद्रीकृत क्रेडेंशियल, एकीकृत ऑडिट लॉगिंग और एक्सटेंशन पैकेज के माध्यम से प्रतिबंधित कमांड सतह के साथ कस्टम Agents या प्लेटफ़ॉर्म में एम्बेडिंग का समर्थन करता है। यह प्रोजेक्ट Go (v1.23+) में लिखा गया है और npm के माध्यम से वितरित किया जाता है, MIT लाइसेंस के तहत सामुदायिक योगदान का स्वागत है।