README.hi.md

ओपन सोर्स कोडिंग एजेंट, जो किसी भी मॉडल के साथ काम करता है।

Codewhale आपका प्रोजेक्ट पढ़ता है, फ़ाइलें संपादित करता है, कमांड चलाता है और अपने काम की खुद जाँच करता है — आपके टर्मिनल में, आपके चुने हुए होस्ट किए गए या लोकल मॉडल के साथ।

वेबसाइट · दस्तावेज़ · बदलावों की सूची · योगदान

English · 简体中文 · 日本語 · Tiếng Việt · Bahasa Indonesia · 한국어 · Español · Português · Русский · Українська · Français · Deutsch · 繁體中文 · Türkçe · Italiano · Polski · العربية · Català

_{कॉन्फ़िगर किए गए स्थानीय डेमो सत्र से Codewhale के असली टर्मिनल का कैप्चर।}

इंस्टॉल करें

macOS और Linux:

curl -fsSL https://codewhale.net/install.sh | sh

इंस्टॉलर चेकसम से सत्यापित बाइनरी ~/.local/bin में डाउनलोड करता है। अगर इसके बाद codewhale चलाने पर "command not found" दिखे, तो इंस्टॉलर जो एक PATH लाइन प्रिंट करता है उसे चलाएँ, या इसे PATH में जोड़ें देखें। कभी भी codewhale update से अपग्रेड करें।

Windows, npm, Cargo और अन्य तरीके

winget install HunterBown.CodeWhale  # Windows x64 (or Scoop, or the installer from GitHub Releases)
npm install -g codewhale            # wraps the same release binaries
cargo install codewhale-cli --locked  # build from crates.io

Docker, Linux पर Nix और Homebrew, Android/Termux, चेकसम सत्यापन के साथ मैन्युअल डाउनलोड और वैकल्पिक CNB मिरर इंस्टॉलेशन गाइड में दिए गए हैं। कोई एक तरीका चुनें: एक मशीन पर कई इंस्टॉलेशन PATH को लेकर आपस में टकराते हैं।

क्विकस्टार्ट

अपने प्रदाताओं की API कुंजियाँ एक ही जगह सँभालें। Codewhale खाता बनाएँ या साइन इन करने के लिए codewhale login चलाएँ। अपने खाते में API कुंजियाँ सहेजें और अपडेट करें, फिर साइन इन किए हुए उपकरणों पर Codewhale के मॉडल रूट के ज़रिए उनका इस्तेमाल करें। खाते की कुंजियाँ सेट अप करें। साइन इन करने से मौजूदा स्थानीय कुंजियाँ अपलोड नहीं होतीं; बिना खाते के भी स्थानीय रूप से काम कर सकते हैं।

1. अपना प्रोजेक्ट खोलें। जिस फ़ोल्डर में काम करना है, उसमें codewhale चलाएँ।
2. कोई मॉडल जोड़ें। होस्टेड कुंजी जोड़ने या कोई लोकल रनटाइम चुनने के लिए /provider चलाएँ (या F3 दबाएँ)। अगर Ollama पहले से किसी चैट मॉडल के साथ चल रहा है, तो Codewhale अपने-आप उस पर चला जाता है। मॉडल बदलने के लिए /model इस्तेमाल करें।
3. कोई ठोस काम बताएँ।

Fix the failing tests and explain what changed.

यही काम किसी स्क्रिप्ट या CI जॉब से बिना इंटरफ़ेस के भी चलता है:

codewhale exec --auto "fix the failing tests and explain what changed"

कमांड और कीबोर्ड शॉर्टकट देखने के लिए /help चलाएँ।

इसे चलाने के तरीके

हर क्लाइंट उसी लोकल Codewhale Runtime को चलाता है, इसलिए सेशन, टूल और अनुमतियाँ हर जगह एक जैसे व्यवहार करते हैं।

कमांड	क्या करता है
codewhale	इंटरैक्टिव टर्मिनल इंटरफ़ेस
codewhale exec "…"	किसी स्क्रिप्ट या CI से एक बिना इंटरफ़ेस वाला टर्न; --auto फ़ाइल और शेल टूल की अनुमति देता है, --output-format stream-json JSON स्ट्रीम करता है
codewhale web	127.0.0.1 पर पैकेज में शामिल लोकल ब्राउज़र क्लाइंट
codewhale review --pr N	सलाह के रूप में pull request समीक्षा; पोस्ट करना वैकल्पिक है
Runtime API	थ्रेड, इवेंट और अनुमोदन के लिए लोकल HTTP API

एक नेटिव डेस्कटॉप ऐप (GPUI) साइन-इन किए गए प्रोडक्ट क्लाइंट के रूप में बनाया जा रहा है; उपलब्धता के लिए प्रोडक्ट पेज देखें। समुदाय द्वारा अनुरक्षित VS Code एक्सटेंशन साइडबार से उसी Runtime से जुड़ता है (सोर्स)।

यह क्या करता है

• कोई भी मॉडल, कोई बंधन नहीं। 40 से अधिक बिल्ट-इन प्रोवाइडर रूट — Anthropic, DeepSeek, Google, Mistral, Moonshot, OpenAI, OpenRouter, xAI और अन्य — साथ ही कोई भी OpenAI-संगत एंडपॉइंट और Ollama, vLLM या SGLang के ज़रिए लोकल मॉडल। प्रोवाइडर
• नियंत्रण आपके पास रहता है। Plan मोड कुछ बदले बिना पड़ताल करता है; Work और Operate बदलाव करते हैं। अनुमोदन की स्थितियाँ तय करती हैं कि किस टूल कॉल के लिए आपकी मंज़ूरी चाहिए, /undo और /restore वर्कस्पेस के बदलाव वापस लाते हैं, और /receipts सेशन की हर फ़ाइल, कमांड और मंज़ूरी की सूची देता है। मोड · रसीदें
• लंबे कामों के लिए बना। स्थायी /goal तय करें, सीमित काम सब-एजेंटों को सौंपें, खर्च से पहले जाँच के साथ निगरानी में चलने वाली एजेंट टीमें चलाएँ, या उन्हें रिपॉज़िटरी में रखे वर्कफ़्लो के रूप में स्क्रिप्ट करें।
• जो आप पहले से इस्तेमाल करते हैं, उसे बढ़ाएँ। MCP सर्वर जोड़ें, स्किल और प्लगइन इंस्टॉल करें, सेशन और टूल इवेंट पर हुक चलाएँ, और मौजूदा Claude Code प्लगइन लोड करें।
• Computer Use। शामिल प्लगइन दूसरे ऐप देखने और चलाने के टूल जोड़ता है। इस्तेमाल से पहले उसके एक्सेस की समीक्षा करें और उसे सक्षम करें। गाइड

मोड और अनुमतियाँ

	कैसे चुनें	विकल्प
Mode — एजेंट क्या कर रहा है	Tab या /mode	Plan (पड़ताल, कोई बदलाव नहीं) · Work (संपादन और कमांड चलाना) · Operate (नियोजित और सत्यापित चरणों से किसी लक्ष्य तक पहुँचना)
Posture — पहले कब पूछता है	Shift+Tab	Ask · Auto-Review · Full Access

Full Access भी नीति की बाध्यकारी सीमाओं का पालन करता है। मोड और अनुमतियों की गाइड हर विकल्प को समझाती है।

सुरक्षा

Codewhale आपकी मशीन पर उतने ही एक्सेस के साथ चलता है जितना आप उसे देते हैं। अनुमोदन की स्थितियाँ और रिपॉज़िटरी के नियम एजेंट की गतिविधियों को सीमित करते हैं, और जहाँ समर्थन है वहाँ कमांड OS सैंडबॉक्स के भीतर चलते हैं (macOS पर Seatbelt; Linux पर bubblewrap, जब वह इंस्टॉल हो और ठीक से काम कर रहा हो)। कुछ भी भेजे जाने से पहले /preview-request सटीक, संपादित (redacted) अनुरोध दिखाता है। जिन मॉडलों की कीमत ज्ञात नहीं है, उन्हें मुफ़्त बताने के बजाय अज्ञात ही दिखाया जाता है।

अधिकार क्रम, सैंडबॉक्सिंग और टेलीमेट्री देखें — उपयोग की गिनती डिफ़ॉल्ट रूप से चालू रहती है और codewhale config set telemetry false उसे बंद कर देता है।

दस्तावेज़

यहाँ से शुरू करें	और गहराई में जाएँ
इंस्टॉलेशन	कॉन्फ़िगरेशन
प्रोवाइडर और लोकल मॉडल	आर्किटेक्चर
मोड और अनुमतियाँ	Runtime API
कीबाइंडिंग	प्लगइन लेखन
GitHub PR समीक्षा	सभी दस्तावेज़

समुदाय

बग रिपोर्ट, फ़ीचर के सुझाव और pull request का स्वागत है — चाहे आप Codewhale का कई महीनों से इस्तेमाल कर रहे हों या पहली बार आज़मा रहे हों। अगर कोई प्रोवाइडर उपलब्ध नहीं है या कोई वर्कफ़्लो असहज है, तो issue खोलें या pull request भेजें। पहले योगदान का स्वागत है, और स्वीकार किए गए काम का श्रेय योगदानकर्ताओं के पास रहता है। रिपॉज़िटरी की संरचना शुरुआत के लिए अच्छी जगह है।

Discord से जुड़ें, या WeChat पर Hunter (hunterbown) को जोड़कर Whale Brothers समूह में शामिल होने के लिए कहें।

इतिहास और लाइसेंस

Codewhale की शुरुआत deepseek-tui के रूप में हुई थी और यह आज भी उस प्रोजेक्ट का कॉन्फ़िगरेशन और सेशन पढ़ता है। अब यह किसी प्रोवाइडर पर निर्भर नहीं है, स्वतंत्र रूप से अनुरक्षित है और किसी भी मॉडल प्रोवाइडर से संबद्ध नहीं है। हर योगदानकर्ता और प्रोजेक्ट को आगे बढ़ाने वाले ओपन सोर्स समुदायों का धन्यवाद।

MIT। अन्य ओपन सोर्स प्रोजेक्ट से लिए और अनुकूलित किए गए हिस्से थर्ड-पार्टी नोटिस में दर्ज हैं।