Bucket

Reflag CLI

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

इंस्टॉलेशन

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

# npm
npm install --save-dev @reflag/cli

# yarn
yarn add --dev @reflag/cli

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

# 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 पैटर्न को अपडेट करें।

व्यक्तिगत कमांड्स

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

# Initialize Reflag in your project (if not already setup)
npx reflag init

# Create a new flag
npx reflag flags create "My Flag"

# Generate TypeScript types for your flags
npx reflag flags types

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

CLI आपके प्रोजेक्ट डायरेक्टरी में reflag.config.json फ़ाइल बनाता है जब आप reflag init चलाते हैं। इस फ़ाइल में आपके 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 नियमों और Model Context Protocol (MCP) के माध्यम से शक्तिशाली AI-सहायता प्राप्त विकास क्षमताएँ प्रदान करता है। ये सुविधाएँ आपके AI विकास उपकरणों को आपके फ्लैग्स को बेहतर ढंग से समझने और अधिक सटीक सहायता प्रदान करने में मदद करती हैं।

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 निर्देश बनाए रख सकते हैं।

Model Context Protocol

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

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

MCP सेट करना

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

npx reflag mcp [--editor <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 Streaming का समर्थन करता है, तो आप सीधे Reflag MCP सर्वर से जुड़ सकते हैं।

CI/CD पाइपलाइनों में उपयोग

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

# Generate types in 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 example
- name: Generate types
  run: npx reflag flags types --api-key ${{ secrets.REFLAG_API_KEY }}

# GitHub Actions example (using environment):
- name: Generate types (environment)
  run: npx reflag flags types
  env:
    REFLAG_API_KEY: ${{ secrets.REFLAG_CI_API_KEY }}

विकास

# Build the CLI
yarn build

# Run the CLI locally
yarn reflag [command]

# Lint and format code
yarn lint
yarn format

आवश्यकताएँ

• Node.js >=18.0.0

लाइसेंस

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