मॉडल किसी का भी हो सकता है। एजेंट आपका होना चाहिए।
Codewhale आपके टर्मिनल के लिए एक ओपन सोर्स कोडिंग एजेंट है, जो Rust में लिखा गया है। यह किसी भी मॉडल के साथ काम करता है, एक काम को कई एजेंटों में बाँट सकता है, और इसकी हर पंक्ति आप पढ़ सकते हैं।
```bash
curl -fsSL https://codewhale.net/install.sh | sh
```
यह macOS या Linux पर नवीनतम रिलीज़ इंस्टॉल करता है, और इसके लिए खाते की ज़रूरत नहीं है। [Windows, npm और Cargo](#इंस्टॉल-करें) नीचे हैं।
[](https://github.com/codewhale-hq/Codewhale/releases/latest)
[](https://github.com/codewhale-hq/Codewhale/actions/workflows/ci.yml)
[](../../LICENSE)
[](https://discord.gg/37gfS3ksug)
[वेबसाइट](https://codewhale.net) · [दस्तावेज़](../README.md) · [बदलाव सूची](../../CHANGELOG.md) · [योगदान](../../CONTRIBUTING.md)
[English](../../README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md) · [Tiếng Việt](README.vi.md) · [Bahasa Indonesia](README.id.md) · [한국어](README.ko-KR.md) · [Español](README.es-419.md) · [Português](README.pt-BR.md) · [Русский](README.ru.md) · [Українська](README.uk.md) · [Français](README.fr.md) · [Deutsch](README.de.md) · [繁體中文](README.zh-TW.md) · [Türkçe](README.tr.md) · [Italiano](README.it.md) · [Polski](README.pl.md) · [العربية](README.ar.md) · [Català](README.ca.md)
यह अनुवाद मशीन द्वारा बनाया गया मसौदा है और इसकी अभी किसी मूल भाषी द्वारा समीक्षा नहीं हुई है।स्क्रिप्ट किए गए टेस्ट मॉडल वाला 0.10.3 का डेवलपमेंट बिल्ड (0.10.3 अभी रिलीज़ नहीं हुआ है), एक बार इस्तेमाल होने वाले वर्कस्पेस में Full Access में। बदलाव, तीन टेस्ट और एक सब-एजेंट समीक्षा वाकई चले।
## इंस्टॉल करें
ऊपर का कमांड चेकसम से जाँचा गया `codewhale` और उसका छोटा नाम `codew` `~/.local/bin` में रखता है। अगर इसके बाद आपका शेल `command not found` कहे, तो इंस्टॉलर जो PATH नोट दिखाता है उसका पालन करें ([विवरण](../INSTALL.md#put-it-on-your-path))। `codewhale update` इसे अपग्रेड करता है।
```bash
winget install --id HunterBown.CodeWhale --exact --source winget # Windows x64
npm install -g codewhale # wraps the same release binaries
cargo install codewhale-cli --locked # builds from source; can trail GitHub Releases
```
पहले से बनी बाइनरी x64 और arm64 पर Linux, macOS और Windows के लिए हैं। Scoop, Nix, Linux पर Homebrew, Android और Termux (प्रीव्यू) और मैन्युअल डाउनलोड [इंस्टॉलेशन गाइड](../INSTALL.md) में हैं, और कंटेनर [Docker](../DOCKER.md) में। हर मशीन पर एक ही इंस्टॉल तरीका अपनाएँ; वरना आपके `PATH` पर दो प्रतियाँ होंगी और जो पहले मिलेगी वही चलेगी।
## जल्दी शुरुआत
1. अपना काम commit या stash करें, फिर किसी git रिपॉज़िटरी की रूट से `codewhale` चलाएँ। डिफ़ॉल्ट रूप से यह रिपॉज़िटरी में फ़ाइल बदलाव बिना पूछे लागू करता है और हर उस shell कमांड से पहले पूछता है जो सिर्फ़ पढ़ती नहीं।
2. `/provider` चलाएँ (या `F3` दबाएँ), एक प्रदाता चुनें, उसकी API कुंजी चिपकाएँ और मॉडल चुनें। डिफ़ॉल्ट प्रदाता DeepSeek है। बिना कुंजी के पहली बार चलाने पर, जब आप पहला संदेश भेजते हैं तब Codewhale प्रदाता पूछता है, और कोई स्थानीय Ollama सर्वर जवाब दे तो स्थानीय मॉडल सुझाता है।
3. एक काम लिखें:
```text
Fix the failing tests and explain what changed.
```
केवल पढ़ने वाले कमांड तुरंत चलते हैं। किसी भी दूसरे शेल कमांड के लिए Codewhale पहले पूछता है: `y` उसे एक बार चलाता है, `a` बाकी बातचीत के लिए वैसे कमांड की अनुमति देता है, और `n` मना करता है। `/undo` आपका पिछला अनुरोध और उसके फ़ाइल बदलाव वापस लेता है, और `/help` कमांड और कुंजियाँ दिखाता है।
स्क्रिप्ट और CI के लिए `codewhale exec` बिना इंटरफ़ेस के एक काम चलाता है। `--auto` से इसे टूल देने से पहले [बिना इंटरफ़ेस के चलाना](../INSTALL.md#headless-scripts-ci) पढ़ें, क्योंकि जब तक आप सैंडबॉक्स न जोड़ें, `--auto` Full Access इस्तेमाल करता है।
## यह क्या करता है
Codewhale को कोई काम दें, और यह काम पूरा होने या आपके इनपुट की ज़रूरत पड़ने तक रिपॉज़िटरी पढ़ता है, फ़ाइलें बदलता है और कमांड चलाता है। [नवीनतम रिलीज़ नोट्स](https://github.com/codewhale-hq/Codewhale/releases/latest) में सबसे नए बदलाव हैं, और [चेंजलॉग](../../CHANGELOG.md) में हर संस्करण है।
### कोई भी मॉडल
40 से ज़्यादा प्रदाता पहले से शामिल हैं, जिनमें Anthropic, OpenAI, DeepSeek, Google, Mistral, Moonshot, OpenRouter और xAI हैं। कोई भी OpenAI-संगत एंडपॉइंट काम करता है, और Ollama, vLLM या SGLang के ज़रिए स्थानीय मॉडल भी। डिफ़ॉल्ट मॉडल DeepSeek का `deepseek-flash` है, जो अब DeepSeek V4.1 Flash से चलता है ([विवरण](../PROVIDERS.md#deepseek-v41-flash))।
`/model` बारियों के बीच मॉडल बदलता है, और `/model auto` हर बारी के लिए एक मॉडल चुनता है (कैसे, यह `/router` तय करता है)। `/turn inspect` दिखाता है कि किसी बारी ने कौन-सा मॉडल इस्तेमाल किया, उसकी लागत क्या थी और उसमें कितना समय लगा। [प्रदाता](../PROVIDERS.md) देखें।
### रसीदें और वापसी
`/receipts`, या बाहर निकलने के बाद `codewhale receipts --last`, किसी सत्र में बदली गई फ़ाइलें, चलाए गए कमांड, उसके वेब और MCP कॉल, शुरू किए गए एजेंट, हर मंज़ूरी और उसे किसने दिया, और क्या विफल हुआ, यह सब दिखाता है। `/undo` आपका पिछला अनुरोध और उससे बदली गई फ़ाइलें एक ही कदम में वापस लेता है। `/restore` पूरे वर्कस्पेस को पहले के स्नैपशॉट पर लौटाता है, और क्योंकि यह बाद के बदलावों को मिटा देता है, इसके लिए `/trust on` या Full Access चाहिए। [रसीदें](../RECEIPTS.md) देखें।
### एक काम पर कई एजेंट
`/goal` एक लक्ष्य तय करता है जो कई बारियों तक चलता है। Codewhale काम को [सब-एजेंटों](../SUBAGENTS.md) में बाँट सकता है, अपनी भूमिकाओं और मॉडलों वाले एजेंटों की [Fleet](../FLEET.md) चला सकता है, या रिपॉज़िटरी में रखे [वर्कफ़्लो](../WORKFLOW_AUTHORING.md) का पालन कर सकता है।
### एक्सटेंशन
[MCP सर्वर](../MCP.md) जोड़ें, [स्किल](../SKILLS.md) और [प्लगइन](../PLUGINS.md) जोड़ें, और सत्र और टूल इवेंट पर [हुक](../HOOKS.md) चलाएँ। कोड मोड (प्रायोगिक, डिफ़ॉल्ट रूप से चालू) मॉडल को एक `execute_tools` प्रोग्राम लिखने देता है जो कई MCP और प्लगइन टूल बुलाता है; हर कॉल फिर भी आपके मंज़ूरी नियमों का पालन करता है और अपनी रसीद रखता है। v0.10.2 के साथ आने वाला Computer Use प्लगइन (प्रायोगिक, केवल macOS) दूसरे ऐप देख और चला सकता है, और जब तक आप इसकी पहुँच की समीक्षा करके इसे चालू नहीं करते, यह बंद रहता है ([गाइड](https://github.com/codewhale-hq/Codewhale/blob/v0.10.2/crates/tui/plugins/computer-use/README.md))। 0.10.3 में आ रहा है: यह प्लगइन [अलग से रिलीज़](https://github.com/codewhale-hq/codewhale-cu-plugin) होगा।
### चलाने के तरीके
| कमांड | यह क्या करता है |
| --- | --- |
| `codewhale` | इंटरैक्टिव टर्मिनल ऐप |
| `codewhale exec "…"` | बिना इंटरफ़ेस के एक काम, स्क्रिप्ट और CI के लिए ([बिना इंटरफ़ेस के चलाना](../INSTALL.md#headless-scripts-ci)) |
| `codewhale web` | `127.0.0.1` पर एक स्थानीय वेब क्लाइंट ([गाइड](../WEB.md)) |
| `codewhale review --pr N` | GitHub पुल रिक्वेस्ट की सलाह देने वाली समीक्षा; [GitHub बॉट सेटअप](../GITHUB_ACTION.md#set-up-your-own-bot) इसे आपकी अपनी मॉडल कुंजी से चलाता है |
| `codewhale app-server --http` | [Runtime API](../RUNTIME_API.md), थ्रेड, इवेंट, मंज़ूरियों और हर बारी के फ़ाइल बदलावों के लिए एक स्थानीय HTTP API |
| `codewhale serve --acp` | stdio पर Agent Client Protocol, Zed जैसे एडिटर के लिए |
टर्मिनल ऐप, `exec`, `web` और Runtime API एक ही इंजन साझा करते हैं ([आर्किटेक्चर](../ARCHITECTURE.md))। समुदाय द्वारा बनाए रखा गया एक [VS Code एक्सटेंशन](https://marketplace.visualstudio.com/items?itemName=HengQuWorld.brotherwhale-vscode) साइडबार से इससे जुड़ता है ([स्रोत](https://github.com/HengQuWorld/CodeWhale-VSCode))।
## यह सुरक्षित कैसे रहता है
दो स्विच तय करते हैं कि Codewhale बिना पूछे कितना कर सकता है। इनपुट खाली होने पर `Tab` मोड बदलता है: **Plan** पढ़ता और खोजता है पर कुछ नहीं बदलता, **Work** फ़ाइलें बदलता और कमांड चलाता है, और **Operate** के पास Work जितनी ही पहुँच है और वह तब तक चलता रहता है जब तक लक्ष्य सत्यापित न हो जाए या उसे आपकी ज़रूरत न हो। `Shift+Tab` अनुमति बदलता है। डिफ़ॉल्ट **Ask** आपकी रिपॉज़िटरी में फ़ाइल बदलाव बिना पूछे लागू करता है और उन shell कमांड से पहले पूछता है जो सिर्फ़ पढ़ती नहीं। **Auto-Review** नियमों और एक समीक्षक मॉडल को सामान्य कॉल मंज़ूर करने देता है और उच्च जोखिम वाली कॉल अस्वीकार करता है; उन्हें खुद मंज़ूर करने के लिए Ask पर जाएँ। **Full Access** कभी नहीं पूछता और Codewhale का sandbox बंद कर देता है, हालाँकि रिपॉज़िटरी नियम और प्रबंधित नीति लागू रहती हैं। विवरण [v0.10.2 गाइड](https://github.com/codewhale-hq/Codewhale/blob/v0.10.2/docs/MODES.md) में है।
0.10.3 में आ रहा है: `Shift+Tab` एक ही डायल बन जाएगा जो Ask, Accept Edits, Plan, Auto-Review और Full Access से होकर गुज़रता है, `Tab` अब मोड नहीं बदलेगा, और Operate हटा दिया जाएगा। Ask हर फ़ाइल बदलाव से पहले भी पूछेगा, और नया डिफ़ॉल्ट Accept Edits git रिपॉज़िटरी के अंदर बदलाव लागू करेगा और कमांड से पहले पूछता रहेगा। [मौजूदा गाइड](../MODES.md) इसका वर्णन करती है।
Ask और Auto-Review में कमांड ऑपरेटिंग सिस्टम के सैंडबॉक्स में चलते हैं, जहाँ सिस्टम में वह हो: macOS पर Seatbelt, और Linux पर bubblewrap अगर वह इंस्टॉल हो। Windows में अभी ऑपरेटिंग सिस्टम सैंडबॉक्स नहीं है, और Full Access सैंडबॉक्स बंद कर देता है। सैंडबॉक्स के अंदर शेल कमांड और टर्मिनल सत्र `~/.ssh`, `~/.aws` और `.env` फ़ाइलों जैसे क्रेडेंशियल भंडार नहीं पढ़ सकते। `/preview-request` अगले अनुरोध का संवेदनशील हिस्सा छिपाकर पूर्वावलोकन दिखाता है, उसे भेजे बिना।
आपको खाते की ज़रूरत नहीं है, और `/provider` से जोड़ी गई कुंजियाँ आपकी मशीन पर रहती हैं। अपनी API कुंजी से आप प्रदाता को सीधे भुगतान करते हैं, और स्थानीय मॉडलों को कुंजी नहीं चाहिए। कीमत पता हो तो फ़ुटर और `/cost` सत्र की लागत दिखाते हैं, और अज्ञात कीमत अज्ञात के रूप में दिखती है, कभी मुफ़्त के रूप में नहीं।
टेलीमेट्री डिफ़ॉल्ट रूप से चालू है। यह कुल गिनतियाँ (संस्करण और प्लेटफ़ॉर्म, सत्र की अवधि और परिणाम, आपने कौन-से अंतर्निहित प्रदाता इस्तेमाल किए, सुविधा और त्रुटि गिनती) एक यादृच्छिक इंस्टॉल ID के साथ भेजती है जो हर 90 दिन में बदलती है, और कभी बातचीत, कोड, प्रॉम्प्ट, मॉडल के नाम, फ़ाइल या रिपॉज़िटरी के नाम, या क्रेडेंशियल नहीं भेजती। यह कमांड इसे बंद करता है:
```bash
codewhale config set telemetry false
```
शुरू होते समय Codewhale GitHub पर नई रिलीज़ भी जाँचता है; इसे छोड़ने के लिए `CODEWHALE_NO_UPDATE_CHECK=1` सेट करें। और जानकारी [प्राधिकरण क्रम](../AUTHORIZATION_ORDER.md), [सैंडबॉक्स](../SANDBOX.md) और [टेलीमेट्री](../TELEMETRY.md) में है।
## यह कहाँ जा रहा है
Codewhale एक ऐसा वातावरण बन रहा है जो आपके टर्मिनल, डेस्कटॉप ऐप, ब्राउज़र और क्लाउड कंप्यूटरों में फैला है, सब एक इंजन से चलता है। नीचे का हर हिस्सा बताता है कि वह आज किस स्थिति में है।
| हिस्सा | स्थिति | आज |
| --- | --- | --- |
| टर्मिनल ऐप | जारी | इसे macOS, Linux या Windows पर इंस्टॉल करें और किसी भी रिपॉज़िटरी में `codewhale` चलाएँ। |
| लोकल ब्राउज़र क्लाइंट | जारी | `codewhale web` चलाकर अपने ब्राउज़र में बातचीत पढ़ें, काम भेजें और मंज़ूरियों का जवाब दें; यह टर्मिनल के साथ आता है और इसके लिए खाते की ज़रूरत नहीं है। |
| एक काम पर कई एजेंट | जारी | सब-एजेंट, Fleet और वर्कफ़्लो कई एजेंटों को एक काम बाँटने देते हैं, हर एक की अपनी भूमिका के साथ। |
| डेस्कटॉप ऐप | विकास में, डाउनलोड नहीं | हम उसी इंजन पर एक डेस्कटॉप ऐप बना रहे हैं, और उसका अभी कोई सार्वजनिक डाउनलोड नहीं है। |
| क्लाउड कंप्यूटर | केवल आमंत्रण | क्लाउड कंप्यूटर केवल आमंत्रण पर हैं, और हम इन्हें इसलिए बना रहे हैं कि एक सत्र क्लाउड की किसी मशीन पर काम करता रह सके। |
| इन सबके पार एक सत्र | निर्माणाधीन | हम एक ऐसा सत्र बना रहे हैं जो टर्मिनल से डेस्कटॉप, ब्राउज़र और क्लाउड तक आपके साथ जाता है, और पूरे रास्ते आपका ही रहता है। |
[रोडमैप](../ROADMAP.md) बताता है कि हर रिलीज़ में क्या है और आप कहाँ मदद कर सकते हैं।
## किसी दूसरे एजेंट से आ रहे हैं
Codewhale `AGENTS.md` अपने आप पढ़ता है। दूसरे टूल के लिए लिखी निर्देश फ़ाइलें, जैसे `CLAUDE.md`, `.cursorrules` या `.github/copilot-instructions.md`, तभी लोड होती हैं जब आप अपने कॉन्फ़िग में `project_instruction_imports = ["claude"]` (या `"cursor"`, `"cline"`, `"windsurf"`, `"copilot"`, `"all"`) से इन्हें चालू करें; [config.example.toml](../../config.example.toml) देखें। ऐसी कोई फ़ाइल मिलने पर जिसे उसने लोड नहीं किया, Codewhale चेतावनी देता है।
`/import-claude` आपकी Claude Code सेटिंग और MCP सर्वरों का आयात आपकी समीक्षा के लिए तैयार करता है। `/plugin install` स्किल, कमांड, एजेंट प्रोफ़ाइल और MCP सर्वर वाले Claude Code प्लगइन स्वीकार करता है, और जिन प्लगइनों को हुक या LSP सर्वर चाहिए उन्हें मना करता है ([विवरण](../CLAUDE_PLUGIN_COMPAT.md))।
## दस्तावेज़
ये गाइड मुख्य ब्रांच के साथ चलती हैं, इसलिए इनमें ऐसे बदलाव हो सकते हैं जो अभी नवीनतम रिलीज़ में नहीं हैं।
| यहाँ से शुरू करें | संदर्भ |
| --- | --- |
| [उपयोगकर्ता गाइड](../GUIDE.md) | [कॉन्फ़िगरेशन](../CONFIGURATION.md) |
| [इंस्टॉलेशन](../INSTALL.md) | [आर्किटेक्चर](../ARCHITECTURE.md) |
| [प्रदाता और स्थानीय मॉडल](../PROVIDERS.md) | [Runtime API](../RUNTIME_API.md) |
| [मोड और अनुमतियाँ](../MODES.md) | [प्लगइन लिखना](../PLUGIN_AUTHORING.md) |
| [कीबाइंडिंग](../KEYBINDINGS.md) | [रसीदें](../RECEIPTS.md) |
| [GitHub पुल रिक्वेस्ट समीक्षा](../GITHUB_ACTION.md) | [सभी दस्तावेज़](../README.md) |
## योगदान
Codewhale को इसे इस्तेमाल करने वाले लोग कई भाषाओं में खुले में बनाते हैं।
[योगदानकर्ता दीवार](../CONTRIBUTORS.md) हर उस व्यक्ति को गिनती है जिसका कोड, सह-लेखक commit, आगे बढ़ाए गए पुल रिक्वेस्ट या श्रेय पाई रिपोर्ट Codewhale में है, उन लोगों समेत जिन्हें GitHub की अपनी योगदानकर्ता सूची छोड़ देती है। `scripts/contributor-wall.py` git इतिहास और GitHub से तस्वीर और सूची दोबारा बनाता है।
हर प्रतिक्रिया का स्वागत है: कोई बग, कोई विचार, या कुछ ऐसा जो दिखने या इस्तेमाल में गलत लगा। इनमें से किसी के लिए भी [issue खोलें](https://github.com/codewhale-hq/Codewhale/issues/new/choose); नई सुविधा शुरू करने के लिए भी issue सबसे अच्छी जगह है। सुधार, अनुवाद, प्रदाता और योजनाबद्ध काम के लिए पुल रिक्वेस्ट का स्वागत है। सवाल [Discussions](https://github.com/codewhale-hq/Codewhale/discussions) में पूछें। [योगदान गाइड](../../CONTRIBUTING.md) बताती है कि हर तरह की मदद कहाँ जाती है, आपका काम आपके नाम के साथ कैसे जुड़ता है, और [कौन-सी चीज़ कहाँ है](../../CONTRIBUTING.md#project-structure)।
[Discord](https://discord.gg/37gfS3ksug) पर बात करें, या मेंटेनर Hunter को WeChat (`hunterbown`) पर जोड़ें और Whale Brothers समूह में शामिल होने को कहें। सबका स्वागत है।
## इतिहास और लाइसेंस
Codewhale `deepseek-tui` के रूप में शुरू हुआ था और अब भी उस प्रोजेक्ट का कॉन्फ़िगरेशन और सत्र पढ़ता है। इसे स्वतंत्र रूप से बनाए रखा जाता है और यह DeepSeek या किसी अन्य मॉडल प्रदाता से संबद्ध नहीं है।
[MIT](../../LICENSE)। दूसरे ओपन सोर्स प्रोजेक्ट से लिया गया कोड तृतीय-पक्ष सूचनाओं में [शामिल स्रोतों](../../THIRD_PARTY_NOTICES.md) और [अपनाए गए डिज़ाइनों](../THIRD_PARTY_NOTICES.md) के लिए सूचीबद्ध है।
स्क्रिप्ट किए गए टेस्ट मॉडल वाला 0.10.3 का डेवलपमेंट बिल्ड (0.10.3 अभी रिलीज़ नहीं हुआ है), एक बार इस्तेमाल होने वाले वर्कस्पेस में Full Access में। बदलाव, तीन टेस्ट और एक सब-एजेंट समीक्षा वाकई चले।
