التوثيق

ثبّت Codna بأمر واحد.

Python 3.10 أو أحدث، وmacOS أو Linux، وgit. لا حاجة لتثبيت Node أو Docker أو خادم.

ثبّتالتوثيق الكامل (يُفتح في علامة تبويب جديدة)GitHub App

التثبيت

ثبّت CLI من PyPI عبر pip أو pipx أو uv. يعمل كل شيء على جهازك. سجّل الدخول للرصيد المُدار، أو احفظ مفتاح مزوّدك في سلسلة مفاتيح نظام التشغيل.

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، وتصل الأخطاء بصيغة JSON على stderr.

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

ثبّت التطبيق على حسابك أو مؤسستك واختر المستودعات. يراجع 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

الأسئلة الشائعة

ما الذي يخرج من جهازي؟ حزمة الأدلة أو الفرق فقط، تُرسل إلى مزوّد النموذج بمفتاحك. يعمل Triage والاستذكار دون اتصال.

أين أبلّغ عن خطأ؟ شغّل codna report. يقدّم البلاغ إلى مستودع الملاحظات العام، ويعود إلى رابط مشكلة مُعبَّأ مسبقاً عندما لا يكون لديك رمز وصول.

الأسئلة الشائعة

pip install codna أو pipx install codna أو uv tool install codna. تحتاج إلى Python 3.10 أو أحدث، وmacOS أو Linux، وgit في PATH. يعمل CLI محلياً بمفتاح النموذج الخاص بك.

Cursor وClaude. ثبّت الإضافة mcp، ثم شغّل codna mcp install --client cursor أو --client claude. لا يكتب الخادم أبداً بيانات اعتماد في إعدادات محرّرك.

يشغّل التطبيق أوامر codna نفسها، مُستضافةً لدى Codna. يراجع كل طلب سحب، ويجيب على @codna review، ويفتح إصلاحاً عندما يردّ متعاون لديه صلاحية كتابة بـ @codna fix على نتيجة، ويتصرف مع التسميتين codna-fix وcodna-secure ومع مجموعات الفحص الحمراء.

يعمل CLI على جهازك. يعيش مفتاح مزوّدك في سلسلة مفاتيح نظام التشغيل ولا يُطبع أبداً. لا يصل إلى مزوّد النموذج إلا حزمة الأدلة أو الفرق. اضبط privacy.egress على fail-closed في codna.yaml فلا يشغّل Codna اختباراتك إلا تحت منع للشبكة على مستوى النواة ولا يجري أي استعلام للسجلات أثناء المراجعة.

على 87 حالة متطابقة مقابل Cursor، بلغ متوسط Codna 16,159 رمزاً ونحو 0.02 دولار من إنفاق النموذج لكل إصلاح موثَّق، برموز أقل بـ 5 أضعاف وسرعة أكبر بـ 1.7 ضعف.

تُبنى خريطة المستودع من أنماط الاستيراد، فهي غير مرتبطة بلغة واحدة. يغطي الاستذكار على الجهاز Python وJavaScript وTypeScript وGo وRust وJava وC وC++ وC# وPHP وRuby. اضبط fix.test_command على مشغّل اختباراتك.