CLI और ओपन एक्सेस

/cli पेज खोलें — बाएँ नेविगेशन में CLI और ओपन एक्सेस वहीं जाता है, नए पेज पर — और दोनों में से एक रास्ता चुनें:

• AI agent के ज़रिए इंस्टॉल करें (डिफ़ॉल्ट टैब) — कार्ड पर लिखा प्रॉम्प्ट अपने AI असिस्टेंट (Claude Code, Cursor, Codex सभी चलते हैं) को कॉपी करें, और वह खुद skill इंस्टॉल कर देगा।
• हाथ से इंस्टॉल करें — दो चरण: पहले कार्ड पर लिखा npm कमांड चलाएँ, फिर अगले सेक्शन के हिसाब से साइन इन करें।

यह एक npm पैकेज है, इसलिए पहला चरण सभी प्लेटफॉर्म पर एक ही कमांड है, बशर्ते मशीन में Node.js 20 या उससे नया हो:

npm i -g @dotv/cli

हाथ से इंस्टॉल करने पर सिर्फ़ कमांड आते हैं, और कुछ नहीं। एक और कमांड चलाएँ, ताकि इन कमांड का मैनुअल भी इंस्टॉल हो — वह ~/.claude/skills में जाता है, और आपका AI असिस्टेंट वहीं से यह कमांड सरफेस पहचानता है (सिर्फ़ मौजूदा प्रोजेक्ट में चाहिए हो तो --dir .claude/skills जोड़ें):

dotv skill install

यही कमांड मैनुअल अपडेट करने का भी काम करता है: अगर आपके पास पहले से लेटेस्ट है तो एक बाइट भी नहीं लिखेगा। CLI अपग्रेड करने से मैनुअल अपने आप अपडेट नहीं होता — इसलिए जब आपके मशीन पर मौजूद मैनुअल पीछे छूट जाए, तो dotv अगले कमांड के आउटपुट में एक लाइन की चेतावनी देता है। इंस्टॉल करने के बाद AI असिस्टेंट को रीस्टार्ट करना न भूलें, ताकि नई skill पढ़ सके।

टर्मिनल में न तो ब्राउज़र होता है और न आपको वहाँ पासवर्ड टाइप करना चाहिए, इसलिए यह डिवाइस कोड के रास्ते जाता है — लेकिन आपको टाइप करना सिर्फ़ यही एक लाइन है:

dotv login

यह एक शॉर्ट कोड वाला URL प्रिंट करता है और आपके लिए ब्राउज़र खोलने की कोशिश करता है। स्क्रीन पर दिख रहा कोड और टर्मिनल में दिख रहा कोड एक ही स्ट्रिंग है यह जाँच लें, फिर मंज़ूरी दें। वह URL किसी भी ब्राउज़र वाली मशीन पर खोला जा सकता है — यही इस फ्लो का मकसद है: सर्वर पर चल रहे कमांड-लाइन में तो बिल्कुल ब्राउज़र नहीं होता।

मंज़ूरी देने के बाद कुछ और करने की ज़रूरत नहीं: यह खुद सेशन टोकन को एक लॉन्ग-लाइव्ड कुंजी में बदलता है और ~/.dotv/ में सेव कर देता है (परमिशन 0600), और उसके बाद हर कमांड उसी कुंजी का इस्तेमाल करता है। (अगर कोई agent या CI खुद डिवाइस कोड फ्लो चलाना चाहे, तो चार स्टेप और चार पोलिंग आउटकम auth.md में लिखे हैं।)

dotv login जो कुंजी देता है वह सिर्फ़ आपकी मशीन के ~/.dotv/ में रहती है; हमारे पास उसका हैश सेव रहता है।

• यह वेब से साइन आउट करने पर भी काम करना बंद नहीं करती, और खुद से एक्सपायर भी नहीं होती।
• dotv api-key list आपके द्वारा जारी की गई कुंजियाँ दिखाता है (सिर्फ़ प्रिफ़िक्स, असली टेक्स्ट कभी नहीं), और dotv api-key delete --id <id> से एक अलग से रद्द की जाती है — रद्द तुरंत असरदार होता है, कोई ग्रेस पीरियड नहीं, कोई अंडू नहीं।
• dotv whoami बताता है कि यह मशीन अभी किस साइट से बात कर रही है और कौन-सी कुंजी इस्तेमाल कर रही है, और सर्वर से वहीं पूछकर चेक करता है कि कुंजी अब भी मान्य है।
• dotv logout सिर्फ़ इस मशीन के ~/.dotv/ में सेव कॉपी हटाता है; कुंजी खुद मान्य रहती है — उसे सच में खत्म करने के लिए ऊपर वाली api-key delete इस्तेमाल करें।
• दूसरी मशीन पर dotv login फिर से चलाएँ; CI में ब्राउज़र नहीं होता, इसलिए डिवाइस कोड फ्लो नहीं चल सकता, पहले से बनी कुंजी DOTV_API_KEY एनवायरनमेंट वेरिएबल में दे दें।

कुंजी हमेशा सिर्फ़ आपकी होती है, टीम में कोई और नहीं देख सकता। वेब पर कुंजी बनाने का कोई रास्ता नहीं है — यह सिर्फ़ कमांड लाइन वाला काम है।

इसे skill की तरह इंस्टॉल करके सहायक को मैनुअल के अनुसार कमांड टाइप करवाने के अलावा, dotv खुद एक MCP सर्वर के रूप में चल सकता है: Claude Code, Codex, Claude Desktop, Cursor जैसे MCP-सक्षम ऐप बिना टर्मिनल के इसे सीधे टूल की तरह इस्तेमाल करते हैं।

dotv mcp --print-config
claude mcp add "dotv" -- npx -y @dotv/cli mcp

पहली कमांड वह स्निपेट छापती है जो हर ऐप की कॉन्फ़िग में चिपकाया जा सकता है; दूसरी Claude Code के लिए एक ही पंक्ति में सब कर देती है। जुड़ने के बाद सहायक को तीन टूल मिलते हैं — dotv (कमांड लाइन जैसी ही एक कमांड चलाना), dotv_help (संदर्भ देखना) और dotv_wait (नोड के एक बैच का जनरेशन पूरा होने तक रुकना) — और मैनुअल खुद रिसोर्स के रूप में उपलब्ध रहता है, इसलिए अलग से skill इंस्टॉल करने की ज़रूरत नहीं। कुंजी वही है जो dotv login ने सहेजी थी; और कुछ कॉन्फ़िगर नहीं करना।

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

सहायक का हर काम इसी कैनवास के Agent टाइमलाइन में दर्ज होता है: उसने क्या किया, कौन सा नोड बदला, कौन सी जनरेशन भेजी और नतीजा पूरा हुआ या नहीं — सब कैनवास पर देखा जा सकता है। आपके साइन-इन किए अन्य उपकरणों को भी सूचना मिलती है। डेस्कटॉप ऐप न हो तो नतीजा क्लाउड प्रोजेक्ट में सुरक्षित रहता है; कैनवास पर लौटकर वही दिखेगा।

सहायक के लिए अलग कुंजी बनाकर उस पर सीमा लगाना बेहतर है; सीमा पूरी होने पर खर्च रुक जाता है:

dotv api-key post --name "claude-code" --budget-credits 500

dotv

ग्रुप बताता है कि कमांड किस चीज़ पर काम करती है और एक्शन बताता है कि वह क्या करती है, जैसे: dotv canvas list, dotv generate post-image, dotv model। ऑप्शन का नाम फील्ड का नाम है, camelCase को हाइफ़न में बदलकर: canvasId → --canvas-id।

पूरा रेफ़रेंस /cli पेज के निचले आधे में है: हर कमांड कौन-से ऑप्शन लेता है, किस टाइप के हैं, ज़रूरी हैं या नहीं, और क्या रिटर्न करता है (सीधा कमांड रेफ़रेंस मूल फाइल भी खोल सकते हैं)। इस सेक्शन में वह दोहराया नहीं जाता — कमांड रेफ़रेंस CLI के साथ अपडेट होता है, इसलिए हमेशा उसी को मानें।

बैच स्क्रिप्ट लिखने से पहले देख लेने लायक दो कमांड:

• dotv model (या dotv model list) — अभी उपलब्ध मॉडलों की सूची: key, औपचारिक नाम, किस नोड प्रकार से जुड़े। --node-type video से एक प्रकार देखें, --keyword kling से नाम से छानें।
• dotv model --key <key> — उस एक मॉडल के पैरामीटर: हर पैरामीटर का टाइप, संभावित मान / रेंज, डिफ़ॉल्ट, ज़रूरी है या नहीं — sync के data या post-generate के --params (एक बार का ओवरराइड) में जैसे का तैसा लिखें।

यह सूची वही है जो वेब कंपोज़र के इनपुट बार के मॉडल ड्रॉपडाउन में है (मॉडल और कीमत 14.8 में): इंटरफ़ेस में जो नहीं चुन सकते, वह यहां भी नहीं मिलेगा।

कमांड लाइन से दिखने वाली चीज़ें भी उसी तरह स्कोप्ड होती हैं (14.2 देखें):

• कोई स्पेस आर्ग्युमेंट नहीं = पर्सनल स्पेस;
• --x-team-id <टीम id> के साथ = उस टीम का स्पेस (टीम ID टीम मैनेजमेंट के हेडर की दाईं ओर के ⋯ में होता है, एक क्लिक से कॉपी हो जाता है)।

कमांड लाइन से जनरेट करना उसी वॉलेट से कटता है, कीमत वेब से बिल्कुल एक जैसी होती है (14.8 देखें)। हिसाब मिलाने के लिए तीन कमांड:

• dotv credits wallet — बैलेंस और लेजर। बैलेंस तीन बाल्टियों का कुल है, और रिस्पॉन्स में जनरल क्रेडिट वाली बाल्टी का अलग नंबर भी होता है (बाल्टियों में फर्क 14.3 में);
• dotv credits estimate — पहले कीमत पूछें, फिर चलाएँ या न चलाएँ, एक साथ कई शॉट पूछ सकते हैं (पूरे शॉट शीट के दर्जनों शॉट एक साथ पूछना साधारण इस्तेमाल है);
• dotv membership — इस स्पेस का अभी कौन-सा प्लान है, कब तक, हर महीने कितने क्रेडिट, और एक साथ कितने टास्क चला सकते हैं।

हर कमांड --json लेता है, ताकि आउटपुट सीधे अगले प्रोग्राम में पाइप किया जा सके।