Docs

Installez Codna en une commande.

Python 3.10 ou plus récent, macOS ou Linux, et git. Ni Node, ni Docker, ni serveur à installer.

Installer

Installez la CLI depuis PyPI avec pip, pipx ou uv. Tout tourne sur votre machine. Connectez-vous pour le crédit géré, ou stockez votre propre clé de fournisseur dans le trousseau du système.

pip install codna
codna --version
codna key set anthropic

Démarrage rapide

D'abord, comprenez un dépôt pour zéro token. Puis demandez à Codna de corriger un problème précis.

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

CLI

Triage, fix, review et secure. Chaque commande accepte --json, et les erreurs arrivent en JSON sur 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

Serveur MCP

Installez l'extra mcp, puis ajoutez Codna à Cursor ou Claude en une commande. Cinq outils : codna_triage, codna_fix, codna_secure, codna_recall et codna_report_bug.

pip install "codna[mcp]"
codna mcp install --client cursor
codna mcp install --client claude

GitHub App

Installez l'App sur votre compte ou votre organisation et choisissez les dépôts. Codna relit chaque pull request. Liez l'installation à un compte Codna pour les corrections gérées, ou ajoutez votre propre clé.

# On a pull request
@codna review
# Reply on a Codna finding (write access)
@codna fix
# On an issue
label: codna-fix  ·  codna-secure

Configuration

codna.yaml contient le fournisseur de modèle, les réglages de confidentialité et votre commande de test. Le masquage des secrets est toujours actif.

model:
  provider: anthropic
  key: env:ANTHROPIC_API_KEY
privacy:
  egress: fail-closed
  redact_secrets: true
fix:
  test_command: pytest -q

FAQ

Qu'est-ce qui sort de ma machine ? Seulement le dossier de preuves ou le diff, envoyé à votre fournisseur de modèle avec votre clé. Le triage et le rappel fonctionnent hors ligne.

Où signaler un bug ? Lancez codna report. Il dépose le signalement dans le dépôt public de retours, et se rabat sur un lien d'issue prérempli quand vous n'avez pas de token.

Questions fréquentes

pip install codna, pipx install codna ou uv tool install codna. Il vous faut Python 3.10 ou plus récent, macOS ou Linux, et git dans votre PATH. La CLI tourne en local avec votre propre clé de modèle.

Cursor et Claude. Installez l'extra mcp, puis lancez codna mcp install --client cursor ou --client claude. Le serveur n'écrit jamais d'identifiants dans la configuration de votre éditeur.

L'App exécute les mêmes commandes codna, hébergée par Codna. Elle relit chaque pull request, répond à @codna review, ouvre une correction quand un collaborateur avec accès en écriture répond @codna fix sur un constat, et agit sur les étiquettes codna-fix et codna-secure ainsi que sur les check suites rouges.

La CLI tourne sur votre machine. Votre clé de fournisseur vit dans le trousseau du système et n'est jamais affichée. Seul le dossier de preuves ou le diff atteint votre fournisseur de modèle. Réglez privacy.egress sur fail-closed dans codna.yaml et Codna n'exécute vos tests que sous blocage réseau au niveau du noyau et ne fait aucune requête au registre pendant la relecture.

Sur 87 cas appariés face à Cursor, Codna a utilisé en moyenne 16 159 tokens et environ 0,02 $ de dépense de modèle par correction vérifiée, 5× moins de tokens et 1,7× plus vite.

La carte du dépôt est construite à partir des motifs d'import, elle n'est donc pas liée à un langage. Le rappel sur l'appareil couvre Python, JavaScript, TypeScript, Go, Rust, Java, C, C++, C#, PHP et Ruby. Réglez fix.test_command sur votre propre lanceur de tests.