पूरा संदर्भ
यह पेज आपको इंस्टॉल कराकर पहला फ़िक्स शिप करने तक ले जाता है। पूरा दस्तावेज़ CLI, रिव्यू, MCP सर्वर, GitHub App, GitHub Action, कॉन्फ़िगरेशन और मूल अवधारणाओं को docs.codna.ai पर कवर करता है।
डॉक्स
Codna एक कमांड में इंस्टॉल करें।
Python 3.10 या नया, macOS या Linux, और git। Node, Docker या सर्वर इंस्टॉल करने की ज़रूरत नहीं।
इंस्टॉल
pip, pipx या uv से PyPI से CLI इंस्टॉल करें। सब कुछ आपकी मशीन पर चलता है। प्रबंधित भत्ते के लिए साइन इन करें, या अपनी प्रोवाइडर कुंजी OS कीचेन में सहेजें।
pip install codna codna --version codna key set anthropic
क्विकस्टार्ट
पहले रेपो को शून्य टोकन में समझें। फिर Codna से किसी विशेष इश्यू को ठीक करने को कहें।
codna triage . codna fix . --issue "the checkout test is failing"
CLI
Triage, fix, review और secure। हर कमांड --json लेता है, और त्रुटियाँ stderr पर JSON के रूप में आती हैं।
codna triage . --json codna fix . --tests --apply --max-iterations 3 codna fix https://github.com/org/repo --issue "..." --open-pr codna review . --pr 42 --post codna secure . --from-sarif results.sarif
MCP सर्वर
mcp एक्स्ट्रा इंस्टॉल करें, फिर एक कमांड में Codna को Cursor या Claude में जोड़ें। पाँच टूल: codna_triage, codna_fix, codna_secure, codna_recall और codna_report_bug।
pip install "codna[mcp]" codna mcp install --client cursor codna mcp install --client claude
GitHub App
अपने खाते या संगठन पर App इंस्टॉल करें और रिपॉज़िटरी चुनें। Codna हर पुल रिक्वेस्ट की समीक्षा करता है। प्रबंधित फ़िक्स के लिए इंस्टॉल को Codna खाते से लिंक करें, या अपनी कुंजी जोड़ें।
# On a pull request @codna review # Reply on a Codna finding (write access) @codna fix # On an issue label: codna-fix · codna-secure
कॉन्फ़िगरेशन
codna.yaml में मॉडल प्रोवाइडर, गोपनीयता सेटिंग और आपका टेस्ट कमांड होता है। सीक्रेट रिडैक्शन हमेशा चालू है।
model: provider: anthropic key: env:ANTHROPIC_API_KEY privacy: egress: fail-closed redact_secrets: true fix: test_command: pytest -q
FAQ
मेरी मशीन से क्या बाहर जाता है? केवल एविडेंस बंडल या diff, आपकी कुंजी के साथ आपके मॉडल प्रोवाइडर को भेजा गया। Triage और रिकॉल ऑफ़लाइन चलते हैं।
बग कहाँ रिपोर्ट करूँ? codna report चलाएँ। यह सार्वजनिक फ़ीडबैक रिपॉज़िटरी में दर्ज करता है, और टोकन न होने पर पहले से भरे इश्यू लिंक पर लौट जाता है।
अक्सर पूछे जाने वाले प्रश्न
pip install codna, pipx install codna, या uv tool install codna। आपको Python 3.10 या नया, macOS या Linux, और PATH में git चाहिए। CLI आपकी मॉडल कुंजी से लोकली चलता है।
Cursor और Claude। mcp एक्स्ट्रा इंस्टॉल करें, फिर codna mcp install --client cursor या --client claude चलाएँ। सर्वर कभी आपके एडिटर कॉन्फ़िग में क्रेडेंशियल नहीं लिखता।
App वही codna कमांड चलाता है, Codna द्वारा होस्टेड। यह हर पुल रिक्वेस्ट की समीक्षा करता है, @codna review का उत्तर देता है, जब लिखने की पहुँच वाला सहयोगी किसी निष्कर्ष पर @codna fix उत्तर देता है तो फ़िक्स खोलता है, और codna-fix व codna-secure लेबल तथा लाल चेक सूट पर काम करता है।
CLI आपकी मशीन पर चलता है। आपकी प्रोवाइडर कुंजी OS कीचेन में रहती है और कभी छपती नहीं। आपके मॉडल प्रोवाइडर तक केवल एविडेंस बंडल या diff पहुँचता है। codna.yaml में privacy.egress को fail-closed पर सेट करें और Codna आपके टेस्ट केवल कर्नेल-स्तर नेटवर्क अस्वीकार के तहत ही चलाता है और समीक्षा के दौरान कोई रजिस्ट्री लुकअप नहीं करता।
Cursor के विरुद्ध 87 मिलान किए गए केसों में Codna का औसत 16,159 टोकन और प्रति सत्यापित फ़िक्स लगभग $0.02 मॉडल खर्च रहा, 5× कम टोकन और 1.7× तेज़।
रिपॉज़िटरी मैप इम्पोर्ट पैटर्न से बनता है, इसलिए किसी एक भाषा से बंधा नहीं है। ऑन-डिवाइस रिकॉल Python, JavaScript, TypeScript, Go, Rust, Java, C, C++, C#, PHP और Ruby को कवर करता है। fix.test_command अपने टेस्ट रनर पर सेट करें।