Документация

Установите 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-сервер

Установите extra 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 делает ревью каждого pull request. Привяжите установку к аккаунту 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 и recall работают офлайн.

Куда сообщать об ошибке? Запустите codna report. Она отправит отчёт в публичный репозиторий обратной связи, а без токена предложит предзаполненную ссылку на issue.

Частые вопросы

pip install codna, pipx install codna или uv tool install codna. Нужны Python 3.10 или новее, macOS или Linux и git в PATH. CLI работает локально с вашим ключом модели.

Cursor и Claude. Установите extra mcp, затем выполните codna mcp install --client cursor или --client claude. Сервер никогда не записывает учётные данные в конфигурацию редактора.

App выполняет те же команды codna, размещённое у Codna. Оно делает ревью каждого pull request, отвечает на @codna review, открывает исправление, когда участник с правом записи отвечает @codna fix на находку, и реагирует на метки codna-fix и codna-secure и на красные наборы проверок.

CLI работает на вашей машине. Ключ провайдера хранится в связке ключей ОС и никогда не печатается. До провайдера модели доходит только пакет доказательств или diff. Установите privacy.egress в fail-closed в codna.yaml, и Codna запускает ваши тесты только под запретом сети на уровне ядра и не делает запросов к реестрам во время ревью.

На 87 парных кейсах против Cursor Codna в среднем тратила 16 159 токенов и около $0,02 на модель за проверенное исправление, в 5× меньше токенов и в 1,7× быстрее.

Карта репозитория строится из паттернов импортов, поэтому не привязана к одному языку. Recall на устройстве покрывает Python, JavaScript, TypeScript, Go, Rust, Java, C, C++, C#, PHP и Ruby. Укажите fix.test_command для своего тест-раннера.