دستاویزات

ایک کمانڈ میں Codna انسٹال کریں۔

Python 3.10 یا نیا، macOS یا Linux، اور git۔ Node، Docker یا سرور انسٹال کرنے کی ضرورت نہیں۔

انسٹالمکمل دستاویزات (نئے ٹیب میں کھلتا ہے)GitHub App

مکمل حوالہ

یہ صفحہ آپ کو انسٹال کروا کر پہلا فکس شپ کرنے تک لے جاتا ہے۔ مکمل دستاویزات CLI، ریویو، MCP سرور، GitHub App، GitHub Action، کنفیگریشن اور بنیادی تصورات کا احاطہ docs.codna.ai پر کرتی ہیں۔

مکمل دستاویزات کھولیں (نئے ٹیب میں کھلتا ہے)

انسٹال

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 اپنے ٹیسٹ رنر پر سیٹ کریں۔