Bucket

Reflag CLI

Reflag सेवाओं के साथ इंटरैक्ट करने के लिए कमांड-लाइन इंटरफ़ेस। CLI आपको ऐप्स, फ़्लैग, प्रमाणीकरण प्रबंधित करने और आपके Reflag फ़्लैग के लिए TypeScript प्रकार उत्पन्न करने की अनुमति देता है। इस उपकरण के साथ, आप सीधे अपने टर्मिनल से अपने फ़्लैगिंग वर्कफ़्लो को सुव्यवस्थित कर सकते हैं।

स्थापना

अपने प्रोजेक्ट में CLI को एक विकास निर्भरता के रूप में स्थापित करें:

npm

npm install --save-dev @reflag/cli

yarn

yarn add --dev @reflag/cli

CLI को आरंभ करने, एक फ़्लैग बनाने और एक चरण में TypeScript प्रकार उत्पन्न करने के लिए अपने प्रोजेक्ट की रूट निर्देशिका से new कमांड चलाएँ:

npm

npx reflag new

yarn

yarn reflag new

Bucket SDK से माइग्रेट करना

यदि आप Bucket CLI से माइग्रेट कर रहे हैं, तो यहाँ ध्यान देने योग्य मुख्य परिवर्तन हैं:

• कमांड नाम: bucket से बदलकर reflag हो गया
• प्रकार परिभाषाएँ फ़ाइल: features.d.ts से नाम बदलकर flags.d.ts हो गया (यदि पुरानी फ़ाइल कमिट की गई थी तो उसे मैन्युअल रूप से हटाएँ)
• प्रमाणीकरण फ़ाइल: .bucket-auth से बदलकर .reflag-auth हो गया (पुरानी फ़ाइल का नाम बदलें या हटाएँ)
• कॉन्फ़िगरेशन फ़ाइल: bucket.config.json से बदलकर reflag.config.json हो गया (पुरानी फ़ाइल का नाम बदलें या हटाएँ)
• कमांड: features कमांड अब flags है
• एनवायरनमेंट वेरिएबल: BUCKET_API_KEY के बजाय REFLAG_API_KEY का उपयोग करें

महत्वपूर्ण: इन परिवर्तनों को दर्शाने के लिए अपनी स्क्रिप्ट, बिल्ड चरण और .gitignore पैटर्न अपडेट करें।

अलग-अलग कमांड

अधिक नियंत्रण के लिए, आप प्रत्येक कमांड को अलग-अलग चला सकते हैं:

अपने प्रोजेक्ट में Reflag आरंभ करें (यदि पहले से सेटअप नहीं है)

npx reflag init

एक नया फ़्लैग बनाएँ

npx reflag flags create "My Flag"

अपने फ़्लैग के लिए TypeScript प्रकार उत्पन्न करें

npx reflag flags types

कॉन्फ़िगरेशन

जब आप reflag init चलाते हैं तो CLI आपके प्रोजेक्ट निर्देशिका में एक reflag.config.json फ़ाइल बनाता है। इस फ़ाइल में आपके Reflag एकीकरण के लिए सभी आवश्यक सेटिंग्स होती हैं।

कॉन्फ़िगरेशन फ़ाइल संरचना

यहाँ reflag.config.json फ़ाइल में उपलब्ध सभी कॉन्फ़िगरेशन विकल्प दिए गए हैं:

{ "$schema": "https://unpkg.com/@reflag/cli@latest/schema.json", "baseUrl": "https://app.reflag.com", "apiUrl": "https://app.reflag.com/api", "appId": "ap123456789", "typesOutput": [ { "path": "gen/flags.d.ts", "format": "react" } ] }

विकल्प	विवरण	डिफ़ॉल्ट
$schema	कॉन्फ़िग के लिए ऑटोकम्पलीशन। latest को किसी विशिष्ट संस्करण से बदला जा सकता है।	"https://unpkg.com/@reflag/cli@latest/schema.json"
baseUrl	Reflag सेवाओं के लिए आधार URL।	"https://app.reflag.com"
apiUrl	Reflag सेवाओं के लिए API URL (API कॉल के लिए baseUrl को ओवरराइड करता है)।	"https://app.reflag.com/api"
appId	आपकी Reflag एप्लिकेशन ID।	आवश्यक
typesOutput	पथ जहाँ TypeScript प्रकार उत्पन्न किए जाएँगे। एक स्ट्रिंग या path और format गुणों वाली ऑब्जेक्ट की एक सरणी हो सकती है। उपलब्ध प्रारूप: react और node।	"gen/flags.ts" प्रारूप "react" के साथ

आप अलग-अलग कमांड के लिए कमांड-लाइन विकल्पों का उपयोग करके इन सेटिंग्स को ओवरराइड कर सकते हैं।

कमांड

reflag init

अपने प्रोजेक्ट में एक नया Reflag कॉन्फ़िगरेशन आरंभ करें। यह आपकी सेटिंग्स के साथ एक reflag.config.json फ़ाइल बनाता है और विकल्पों के माध्यम से प्रदान नहीं की गई किसी भी आवश्यक जानकारी के लिए संकेत देता है।

npx reflag init [--overwrite]

विकल्प:

• --overwrite: यदि मौजूद है तो मौजूदा कॉन्फ़िगरेशन फ़ाइल को ओवरराइट करें।
• --app-id <id>: एप्लिकेशन ID सेट करें।
• --key-format <format>: फ़्लैग के लिए कुंजी प्रारूप सेट करें।

reflag new [flagName]

जल्दी शुरू करने के लिए ऑल-इन-वन कमांड। यह कमांड init, फ़्लैग निर्माण और प्रकार उत्पादन को एक ही चरण में जोड़ती है। Reflag के साथ शुरू करने और चलाने के सबसे तेज़ तरीके के लिए इसका उपयोग करें।

npx reflag new "My Flag" [--app-id ap123456789] [--key my-flag] [--key-format custom] [--out gen/flags.ts] [--format react]

विकल्प:

• --key: फ़्लैग के लिए विशिष्ट कुंजी।
• --app-id: उपयोग करने के लिए ऐप ID।
• --key-format: फ़्लैग कुंजियों के लिए प्रारूप (custom, snake, camel, आदि)।
• --out: TypeScript प्रकार उत्पन्न करने का पथ।
• --format: उत्पन्न प्रकारों का प्रारूप (react या node)।

यदि आप प्रत्येक चरण पर अधिक नियंत्रण पसंद करते हैं, तो आप इसके बजाय अलग-अलग कमांड (init, flags create, flags types) का उपयोग कर सकते हैं।

reflag login

अपने Reflag खाते से प्रमाणित करें। यह बाद के संचालन के लिए आपके क्रेडेंशियल्स को सुरक्षित रूप से संग्रहीत करता है।

npx reflag login

reflag logout

अपने Reflag खाते से साइन आउट करें और संग्रहीत क्रेडेंशियल्स हटाएँ।

npx reflag logout

reflag flags

इन उप-कमांड के साथ अपने Reflag फ़्लैग प्रबंधित करें:

reflag flags create [flagName]

अपने Reflag ऐप में एक नया फ़्लैग बनाएँ। यदि विकल्प प्रदान नहीं किए गए हैं तो कमांड आपको इंटरैक्टिव संकेतों के साथ फ़्लैग निर्माण प्रक्रिया के माध्यम से मार्गदर्शन करता है।

npx reflag flags create "My Flag" [--app-id ap123456789] [--key my-flag] [--key-format custom]

विकल्प:

• --key: फ़्लैग के लिए विशिष्ट कुंजी।
• --app-id: उपयोग करने के लिए ऐप ID।
• --key-format: फ़्लैग कुंजियों के लिए प्रारूप।

reflag flags list

वर्तमान ऐप के लिए सभी फ़्लैग सूचीबद्ध करें। यह आपको यह देखने में मदद करता है कि कौन से फ़्लैग उपलब्ध हैं और उनके वर्तमान कॉन्फ़िगरेशन क्या हैं।

npx reflag flags list [--app-id ap123456789]

विकल्प:

• --app-id: उपयोग करने के लिए ऐप ID।

reflag flags types

अपने फ़्लैग के लिए TypeScript प्रकार उत्पन्न करें। यह आपके TypeScript/JavaScript अनुप्रयोगों में Reflag फ़्लैग का उपयोग करते समय प्रकार सुरक्षा सुनिश्चित करता है।

npx reflag flags types [--app-id ap123456789] [--out gen/flags.ts] [--format react]

विकल्प:

• --app-id: उपयोग करने के लिए ऐप ID।
• --out: TypeScript प्रकार उत्पन्न करने का पथ।
• --format: उत्पन्न प्रकारों का प्रारूप (react या node)।

reflag apps

Reflag ऐप्स प्रबंधित करने के लिए कमांड।

वैश्विक विकल्प

इन विकल्पों का उपयोग किसी भी कमांड के साथ किया जा सकता है:

• --debug: वर्बोज़ आउटपुट के लिए डीबग मोड सक्षम करें।
• --base-url <url>: Reflag API के लिए आधार URL सेट करें।
• --api-url <url>: सीधे API URL सेट करें (आधार URL को ओवरराइड करता है)।
• --api-key <key>: गैर-इंटरैक्टिव प्रमाणीकरण के लिए Reflag API कुंजी।
• --help: किसी कमांड के लिए सहायता जानकारी प्रदर्शित करें।

AI-सहायता प्राप्त विकास

Reflag नियमों और मॉडल संदर्भ प्रोटोकॉल (MCP) के माध्यम से शक्तिशाली AI-सहायता प्राप्त विकास क्षमताएँ प्रदान करता है। ये सुविधाएँ आपके AI विकास उपकरणों को आपके फ़्लैग को बेहतर ढंग से समझने और अधिक सटीक सहायता प्रदान करने में मदद करती हैं।

Reflag नियम (अनुशंसित)

rules कमांड आपको अपने प्रोजेक्ट के लिए AI-विशिष्ट नियम सेट करने में मदद करता है। ये नियम AI उपकरणों को यह बेहतर ढंग से समझने में सक्षम बनाते हैं कि Reflag फ़्लैग के साथ कैसे काम करना है और आपके कोडबेस में उनका उपयोग कैसे किया जाना चाहिए।

npx reflag rules [--format <cursor|copilot>] [--yes]

विकल्प:

• --format: नियम जोड़ने का प्रारूप:
  • cursor: Cursor IDE एकीकरण के लिए .cursor/rules/reflag.mdc में नियम जोड़ता है।
  • copilot: GitHub Copilot एकीकरण के लिए .github/copilot-instructions.md में नियम जोड़ता है।
• --yes: पुष्टिकरण संकेतों को छोड़ें और बिना पूछे मौजूदा फ़ाइलों को ओवरराइट करें।

यह कमांड आपके प्रोजेक्ट में ऐसे नियम जोड़ता है जो AI उपकरणों को Reflag फ़्लैग सेट अप करने और उपयोग करने के तरीके के बारे में संदर्भ प्रदान करते हैं। copilot प्रारूप के लिए, नियम फ़ाइल में एक समर्पित अनुभाग में जोड़े जाते हैं, जिससे आप Reflag के नियमों के साथ अन्य copilot निर्देशों को बनाए रख सकते हैं।

मॉडल संदर्भ प्रोटोकॉल

मॉडल संदर्भ प्रोटोकॉल (MCP) एक खुला प्रोटोकॉल है जो AI मॉडलों को विभिन्न डेटा स्रोतों और उपकरणों से जोड़ने का एक मानकीकृत तरीका प्रदान करता है। Reflag के संदर्भ में, MCP आपके कोड संपादक को आपके फ़्लैग, उनकी स्थितियों और आपके कोडबेस के भीतर उनके संबंधों को समझने में सक्षम बनाता है। यह आपके फ़्लैग प्रबंधन वर्कफ़्लो और AI-संचालित विकास उपकरणों के बीच एक सहज सेतु बनाता है। MCP सर्वर Reflag द्वारा होस्ट किया जाता है, जिससे शुरुआत करना आसान हो जाता है।

**नोट: Reflag mcp CLI कमांड पहले एक स्थानीय सर्वर के लिए उपयोग किया जाता था। हालाँकि, Reflag CLI के हाल के संस्करणों में, mcp कमांड को नए दूरस्थ MCP सर्वर से कनेक्ट करने में आपकी सहायता करने के लिए पुनर्निर्मित किया गया है।**

MCP सेट अप करना

mcp कमांड आपको Reflag के दूरस्थ MCP सर्वर से कनेक्ट करने के लिए अपने संपादक या AI क्लाइंट को कॉन्फ़िगर करने में मदद करता है। यह आपके AI उपकरणों को आपके फ़्लैग को समझने और अधिक प्रासंगिक सहायता प्रदान करने की अनुमति देता है।

npx reflag mcp [--editor ] [--scope <local|global>]

विकल्प:

• --editor: कॉन्फ़िगर करने के लिए संपादक/क्लाइंट:
  • cursor: Cursor IDE
  • vscode: Visual Studio Code
  • claude: Claude Desktop
  • windsurf: Windsurf
• --scope: सेटिंग्स को वैश्विक रूप से कॉन्फ़िगर करना है या प्रोजेक्ट के लिए स्थानीय रूप से।

कमांड आपको निम्नलिखित के माध्यम से मार्गदर्शन करेगा:

1. कॉन्फ़िगर करने के लिए कौन सा संपादक/क्लाइंट चुनना है।
2. किस Reflag ऐप से कनेक्ट करना है यह चुनना।
3. वैश्विक या प्रोजेक्ट-स्थानीय कॉन्फ़िगरेशन के बीच निर्णय लेना।
4. आपके चुने हुए संपादक के लिए उपयुक्त कॉन्फ़िगरेशन फ़ाइल सेट करना।

नोट: सेटअप mcp-remote का उपयोग एक संगतता परत के रूप में करता है जो दूरस्थ रूप से होस्ट किए गए Reflag MCP सर्वर को MCP STDIO सर्वर का समर्थन करने वाले सभी संपादकों/क्लाइंट के साथ काम करने की अनुमति देता है। यदि आपका संपादक/क्लाइंट OAuth के साथ HTTP स्ट्रीमिंग का समर्थन करता है तो आप सीधे Reflag MCP सर्वर से कनेक्ट कर सकते हैं।

CI/CD पाइपलाइनों में उपयोग (बीटा)

Reflag CLI को CI/CD पाइपलाइनों में सहजता से काम करने के लिए डिज़ाइन किया गया है। स्वचालित वातावरण के लिए जहाँ इंटरैक्टिव लॉगिन संभव नहीं है, --api-key विकल्प का उपयोग करें या REFLAG_API_KEY एनवायरनमेंट वेरिएबल में API कुंजी निर्दिष्ट करें।

CI/CD में प्रकार उत्पन्न करें

npx reflag apps list --api-key $REFLAG_API_KEY

महत्वपूर्ण प्रतिबंध:

• --api-key का उपयोग करते समय, login और logout कमांड अक्षम हो जाते हैं
• API कुंजियाँ सभी इंटरैक्टिव प्रमाणीकरण प्रवाहों को बायपास करती हैं
• API कुंजियाँ केवल एक ऐप से बंधी होती हैं। apps list जैसे कमांड केवल बंधे हुए ऐप को लौटाएँगे
• अपने CI/CD प्लेटफ़ॉर्म के गुप्त प्रबंधन का उपयोग करके API कुंजियों को सुरक्षित रूप से संग्रहीत करें

उदाहरण CI वर्कफ़्लो:

GitHub Actions उदाहरण

• name: Generate types run: npx reflag flags types --api-key ${{ secrets.REFLAG_API_KEY }}

GitHub Actions उदाहरण (एनवायरनमेंट का उपयोग करके):

• name: Generate types (environment) run: npx reflag flags types env: REFLAG_API_KEY: ${{ secrets.REFLAG_CI_API_KEY }}

विकास

CLI बनाएँ

yarn build

CLI को स्थानीय रूप से चलाएँ

yarn reflag [command]

कोड लिंट और फ़ॉर्मेट करें

yarn lint yarn format

आवश्यकताएँ

• Node.js >=18.0.0

लाइसेंस

MIT लाइसेंस कॉपीराइट (c) 2025 Bucket ApS