सीएलआई संदर्भ

सभी i1n CLI कमांड, फ़्लैग और विकल्पों के लिए पूर्ण संदर्भ।

अवलोकन

i1n CLI स्थानीयकरण (localization) को प्रबंधित करने के लिए प्राथमिक इंटरफ़ेस है। इसे npm i -g i1n के साथ विश्व स्तर पर इंस्टॉल करें।

सभी कमांड वर्तमान प्रोजेक्ट डायरेक्टरी के संदर्भ में, i1n.config.json से कॉन्फ़िगरेशन का उपयोग करके चलाए जाते हैं।

i1n init

किसी प्रोजेक्ट में i1n इनिशियलाइज़ करें। एक इंटरैक्टिव सेटअप चलाता है जो आपके प्रोजेक्ट फ्रेमवर्क का पता लगाता है, लोकेल फ़ाइल प्रारूप और निर्देशिका सेट करता है, स्रोत भाषा को कॉन्फ़िगर करता है, और i1n.config.json बनाता है।

यह कमांड केवल प्रति प्रोजेक्ट एक बार चलाने की आवश्यकता है। सेटिंग्स को पुन: कॉन्फ़िगर करने के लिए इसे फिर से चलाएँ।

i1n push

स्थानीय अनुवाद फ़ाइलों को i1n पर पुश करें। CLI आपकी स्थानीय फ़ाइलों (जैसे locales/**/*.json) को स्कैन करता है और सभी कुंजियों को प्रोजेक्ट में सिंक करता है।

पुश करने के बाद AI अनुवाद को ट्रिगर करने के लिए --translate [langs] का उपयोग करें। उदाहरण: i1n push --translate es,fr,de,ja स्पेनिश, फ्रेंच, जर्मन और जापानी में अनुवाद करता है।

यदि अंतिम सिंक के बाद से किसी कुंजी और भाषा को दोनों तरफ से संपादित किया गया है (एक वास्तविक संघर्ष), तो CLI इंटरैक्टिव रूप से संकेत देता है: स्थानीय मान रखें, सर्वर मान स्वीकार करें, या पुश को निरस्त करें। केवल-सर्वर परिवर्तन (आपके काम करने के दौरान किसी अन्य उपयोगकर्ता द्वारा या डैशबोर्ड में किए गए संपादन) पुश के समय स्वचालित रूप से आपकी स्थानीय फ़ाइलों में लिख दिए जाते हैं, और आवश्यकता पड़ने पर i1n.d.ts को पुनर्जीवित किया जाता है।

उपलब्ध फ्लैग्स: --translate [langs] पुश के बाद AI अनुवाद को ट्रिगर करता है (उदाहरण: i1n push --translate es,fr,de,ja); --strategy <mode> संघर्ष नीति (conflict policy) को सेट करता है: interactive (टर्मिनल में डिफ़ॉल्ट), ours (लोकल जीतता है), theirs (सर्वर जीतता है), या abort (किसी भी संघर्ष पर बाहर निकलें)। --force, --strategy ours के लिए शॉर्टहैंड है और सर्वर मानों को ओवरराइट करता है, जो विनाशकारी है और अन्य लेखकों द्वारा किए गए किसी भी सर्वर-साइड संपादन को हटा देता है。

i1n pull

i1n से अनुवाद प्राप्त करें और स्थानीय फ़ाइलें लिखें। सभी अनुवाद प्राप्त करता है, आपके कॉन्फ़िगर किए गए प्रारूप में स्थानीय फ़ाइलें लिखता है, और i1n.d.ts टाइपस्क्रिप्ट प्रकार परिभाषाएँ उत्पन्न करता है।

अनुवाद पूरा होने के बाद इसे चलाएं, या अपनी CI/CD पाइपलाइन के हिस्से के रूप में यह सुनिश्चित करने के लिए कि फ़ाइलें हमेशा सिंक में रहें।

i1n add-language

अपने प्रोजेक्ट में इंटरैक्टिव रूप से नई लक्ष्य भाषाएँ जोड़ें। यह कमांड आपकी योजना पर उपलब्ध भाषा स्लॉट की जाँच करता है और नए स्लॉट का उपभोग किए बिना पहले से उपयोग की गई भाषाओं को फिर से सक्रिय करने की अनुमति देता है।

भाषा की उपलब्धता आपके प्लान पर निर्भर करती है: स्टार्टर 2 भाषाओं का समर्थन करता है, प्रो 5 भाषाओं का, बिज़नेस 12 भाषाओं का, और एंटरप्राइज सभी 182 भाषाओं का समर्थन करता है।

i1n limits

प्रोजेक्ट सीमाएं और वर्तमान उपयोग प्रदर्शित करें। उपयोग की गई कुंजियाँ बनाम सीमा, उपयोग किए गए एआई अनुवाद क्रेडिट बनाम सीमा, उपयोग किए गए भाषा स्लॉट बनाम उपलब्ध, और सक्रिय भाषाओं की सूची दिखाता है।

उपभोग की निगरानी करने और यह निर्धारित करने के लिए इस कमांड का उपयोग करें कि प्लान अपग्रेड कब आवश्यक हो सकता है।

i1n setup-ai

प्रोजेक्ट के लिए AI एजेंट संदर्भ नियम उत्पन्न करें। कर्सर (.cursor/rules/i1n.mdc), क्लॉड कोड (CLAUDE.md), विंडसर्फ (.windsurfrules), गिटहब कोपायलट (.github/copilot-instructions.md), कोडेक्स (AGENTS.md), और एंटीग्रेविटी (.antigravity/rules.md) के लिए नियम फ़ाइलें बनाता है।

ये फ़ाइलें AI एजेंटों को हार्डकोडेड स्ट्रिंग्स के बजाय अनुवाद कुंजियों का उपयोग करना सिखाती हैं, कुंजियों को सही नेमस्पेस फ़ाइलों में रखती हैं, इंटरपोलेशन चर को बनाए रखती हैं, और संशोधनों के बाद i1n पुश चलाती हैं।

i1n mcp

एक मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) सर्वर शुरू करें जो AI कोडिंग सहायकों को i1n टूल एक्सपोज़ करता है। यह कर्सर, क्लॉड कोड, विंडसर्फ और अन्य MCP-संगत एजेंटों को IDE छोड़े बिना सीधे i1n कमांड निष्पादित करने की अनुमति देता है — पुश, पुल, अनुवाद, भाषाएँ जोड़ना, और बहुत कुछ।

MCP सर्वर 7 टूल एक्सपोज़ करता है: i1n_status, i1n_push, i1n_pull, i1n_translate, i1n_add_language, i1n_extract_and_translate, और i1n_search। मुख्य विशेषता i1n_extract_and_translate है — आपका AI एजेंट किसी कंपोनेंट से हार्डकोडेड स्ट्रिंग्स निकालता है, उन्हें i1n को पास करता है, और वे तुरंत पुश हो जाते हैं, सभी सक्रिय भाषाओं में अनुवादित हो जाते हैं, और टाइप परिभाषाएँ फिर से जेनरेट हो जाती हैं। इसे कॉन्फ़िगर करें: claude mcp add i1n -- npx i1n mcp।

i1n check

नेटवर्क को छुए बिना अपनी स्थानीय अनुवाद फ़ाइलों को मान्य करें: प्रति भाषा गायब कुंजियाँ, टूटे हुए इंटरपोलेशन प्लेसहोल्डर (आपकी स्रोत भाषा की तुलना में {{name}}, {name}, %{name}), खाली मान, खराब फ़ाइलें, और प्रति-भाषा कवरेज। यह उस क्लासिक साइलेंट किलर को पकड़ता है — अनुवाद में खो गया एक वेरिएबल जो रनटाइम पर फॉर्मेटिंग को क्रैश कर देता है।

CI के लिए निर्मित: क्लीन होने पर एक्जिट कोड 0, त्रुटियाँ मिलने पर 1, और कॉन्फ़िगरेशन समस्याओं पर 2। जब अनुवाद कवरेज आपके थ्रेशोल्ड से नीचे गिर जाए तो बिल्ड को विफल करने के लिए --min-coverage 95 जोड़ें, और मशीन-पठनीय रिपोर्ट के लिए --json का उपयोग करें। इसमें किसी API कॉल या सीक्रेट्स की आवश्यकता नहीं है, इसलिए यह किसी भी पाइपलाइन में चलता है。

हमने इसे बनाने के दिन ही अपनी वेबसाइट पर चलाया — इसने 47 टूटे हुए प्लेसहोल्डर्स ढूंढे जो हफ़्तों से प्रोडक्शन में लाइव थे। हर रिलीज़ से पहले npx i1n check चलाएँ。

terminal

i1n init
i1n push
i1n push --translate es,fr,ja
i1n pull
i1n add-language
i1n limits
i1n setup-ai
i1n mcp

.github/workflows/ci.yml

- name: Validate translations
  run: npx i1n check --min-coverage 95