التوثيق

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

أولوية CLI، جاهز لـ MCP، ومتوافق مع GitHub App الأصيل. ابدأ بفهم المستودع المحلي، ثم اربط الإصلاحات وطلبات السحب.

التثبيتGitHub App

التثبيت

ثبّت CLI محليًا. Codna يمكنه العمل على جهازك أو سحابتك أو بنية تحتية مستضافة ذاتيًا.

pip install codna
codna --version

البدء السريع

أولًا، افهم مستودعًا. ثم اطلب من Codna إصلاح مشكلة محددة.

codna triage .
codna fix . --issue "the checkout test is failing"

CLI

الأوامر الأساسية صغيرة ومقابلة للبرمجة النصية عن قصد.

codna triage . --json
codna fix . --issue "..." --tests
codna fix https://github.com/org/repo --issue "..."

خادم MCP

أضف Codna إلى Cursor أو Claude بسطر واحد. وكيلك يمكنه سؤال Codna عن خرائط الرموز والتبعيات وتأثير الاختبارات وحزم الأدلة المركّزة.

codna mcp start --repo .

GitHub App الأصيل

ثبّت GitHub App ليسمح لـ Codna بتصنيف المشكلات والتعليق بأدلة السبب الجذري وفتح طلبات سحب الإصلاح.

# App flow
Install codna → select repos → enable fix PRs

الإعداد

Bring your own model key, or use Codna's managed model — it's the same Codna either way.

model:
  provider: openai
  key: env:CODNA_MODEL_KEY
privacy:
  egress: fail-closed
  redact_secrets: true

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

هل يتدرب Codna على كودي؟ لا. Codna مصمم لعدم التدريب على كود العملاء.

هل يمكنني الاستضافة الذاتية؟ نعم. الاستضافة الذاتية متاحة إلى الأبد، مع خيارات محلية ومعزولة مدعومة لـ Enterprise.

Frequently asked

Install with a single command from your terminal. The codna cli runs locally, so you bring your own API key and your code never leaves your machine unless you choose otherwise.

The MCP server for coding integrates natively with Cursor and Claude. Add it to your editor's MCP config and Codna's graph engine becomes available to your AI assistant without any extra steps.

The GitHub App monitors your repository and opens pull requests with verified fixes automatically. Every fix is validated by your own test suite before the PR is created.

No. Codna is self-hostable, and egress is fail-closed by default. You supply your own API key, and the system is designed so your code is never used for model training.

The deterministic graph engine maps the relevant code first, producing an evidence bundle measured at around 600 tokens. Head-to-head against Cursor, Codna used 5× fewer tokens and ran 1.7× faster, every fix test-verified (87/87).

Codna supports 250+ languages, and has mapped 130 repositories in 9.2 seconds for zero LLM tokens. If your project compiles or resolves dependencies, Codna can graph it.