CLI संदर्भ
यह local installation और inspection commands का reference है। CLI को operator की मशीन पर चलने, bundles को idempotent तरीके से apply करने, और adapter द्वारा वास्तव में support न की जाने वाली capability का दिखावा न करने के लिए डिज़ाइन किया गया है।
मुख्य आर्किटेक्चर
vibebasket CLI एक idempotent local installer की तरह काम करता है। जब bundle URL या local manifest file दी जाती है, यह manifest लाता है, केवल वही capabilities apply करता है जिन्हें target adapter वास्तव में support करता है, unsafe targets या MCP entries को skip करता है, वास्तविक config change ज़रूरी होने पर known config files को mutate करने से पहले backup लिखता है, और target पर readback implement होने पर लिखे गए परिणाम को verify करता है।
उपलब्ध commands
vibebasket apply <url|file>यह primary command है। यह hosted bundle URL या local JSON manifest file स्वीकार करता है, manifest validate करता है, और हर item (MCP servers, skills, rules) को सभी compatible local adapters पर apply करता है। Adapters existing config files का backup केवल तब बनाते हैं जब MCP config mutation वास्तव में ज़रूरी हो, और entries को idempotent तरीके से merge करते हैं; इसलिए apply को दो बार चलाना सुरक्षित है। यदि कोई target bundle के किसी हिस्से को साफ़ तरीके से support नहीं कर सकता, तो CLI install success का दिखावा करने के बजाय उस target को skipped बताता है।
वर्तमान scope
apply मुख्य install path बना रहता है। list, search, doctor, init और rollback जैसे supporting commands आज उपलब्ध हैं।
apply — Flags
| Flag | Type | विवरण |
|---|---|---|
| --force / -f | Boolean | Interactive trust confirmation को skip करता है और यदि वही id पहले से मौजूद हो तो adapter MCP merges को existing MCP entry overwrite करने देता है। |
| --scope / -s | user | project | Bundle के scope को override करता है। user home directory में install करता है, project working directory के सापेक्ष install करता है। |
| --dry-run / -d | Boolean | डिस्क पर लिखे बिना pending config changes का preview दिखाता है। |
| --no-verify | Boolean | Post-install readback checks को skip करता है। यह केवल debugging या ऐसे uncommon local environments के लिए उपयोगी है जहाँ readback अस्थायी रूप से अविश्वसनीय हो। |
अन्य commands
vibebasket list
सभी 24 IDE targets को scan करता है और target के अनुसार installed MCP servers, skills और rules बताता है।
vibebasket search <query>
FTS5 full-text index का उपयोग करके terminal से VibeBasket catalog खोजता है। Hosted catalog में MCPs, Skills और Rules के बीच अधिकतम 10 matching items लौटाता है। वर्तमान terminal surface जानबूझकर हल्का रखा गया है और full visual browsing की बजाय तेज catalog discovery के लिए बेहतर है।
vibebasket init
Project-scoped secrets और assets के लिए local .vibebasket.env file template के साथ .vibebasket/ workspace structure बनाता है।
vibebasket doctor
Local environment का diagnostics करता है: .vibebasket project structure जाँचता है, adapter config presence देखता है, पढ़े जा सकने पर MCP counts रिपोर्ट करता है, और current machine के लिए concise environment summary प्रिंट करता है।
vibebasket rollback
Interactive restore flow खोलता है, हाल के timestamped backups में से चुनने देता है, और फिर चुना गया adapter config snapshot restore करता है। Project-scoped backups के लिए इसे उसी project root से चलाएँ जहाँ restore करना है।
vibebasket mcp serve
Local stdio VibeBasket MCP server चलाता है। यही IDE-facing surface catalog search, target guidance, install planning, bundle apply, backup inspection, rollback और local stack save/load के लिए उपयोग होती है। Cloud stack save अभी भी जानबूझकर website path पर रखा गया है।