Python 3.10 o successivo, macOS o Linux, e git. Niente Node, Docker o server da installare.
Questa pagina ti porta all'installazione e al primo fix. La documentazione completa copre CLI, review, server MCP, GitHub App, GitHub Action, configurazione e concetti chiave su docs.codna.ai.
Apri la documentazione completa (si apre in una nuova scheda)
Installa la CLI da PyPI con pip, pipx o uv. Tutto gira sulla tua macchina. Accedi per il credito gestito, oppure salva la tua chiave del provider nel portachiavi del sistema.
pip install codna codna --version codna key set anthropic
Prima capisci un repo per zero token. Poi chiedi a Codna di correggere un issue specifico.
codna triage . codna fix . --issue "the checkout test is failing"
Triage, fix, review e secure. Ogni comando accetta --json, e gli errori arrivano come JSON su 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
Installa l'extra mcp, poi aggiungi Codna a Cursor o Claude con un comando. Cinque strumenti: codna_triage, codna_fix, codna_secure, codna_recall e codna_report_bug.
pip install "codna[mcp]" codna mcp install --client cursor codna mcp install --client claude
Installa l'App sul tuo account o sulla tua organizzazione e scegli i repository. Codna revisiona ogni pull request. Collega l'installazione a un account Codna per i fix gestiti, oppure aggiungi la tua chiave.
# 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 contiene il provider del modello, le impostazioni di privacy e il tuo comando di test. La redazione dei segreti è sempre attiva.
model: provider: anthropic key: env:ANTHROPIC_API_KEY privacy: egress: fail-closed redact_secrets: true fix: test_command: pytest -q
Cosa esce dalla mia macchina? Solo il pacchetto di evidenze o il diff, inviato al tuo provider di modelli con la tua chiave. Triage e recall funzionano offline.
Dove segnalo un bug? Esegui codna report. Lo registra nel repository pubblico di feedback e, se non hai un token, ricorre a un link di issue precompilato.
pip install codna, pipx install codna o uv tool install codna. Servono Python 3.10 o successivo, macOS o Linux e git nel PATH. La CLI gira in locale con la tua chiave del modello.
Cursor e Claude. Installa l'extra mcp, poi esegui codna mcp install --client cursor o --client claude. Il server non scrive mai credenziali nella configurazione dell'editor.
L'App esegue gli stessi comandi codna, in hosting presso Codna. Revisiona ogni pull request, risponde a @codna review, apre un fix quando un collaboratore con accesso in scrittura risponde @codna fix su un rilievo, e agisce sulle etichette codna-fix e codna-secure e sulle check suite rosse.
La CLI gira sulla tua macchina. La chiave del provider vive nel portachiavi del sistema e non viene mai stampata. Solo il pacchetto di evidenze o il diff raggiunge il tuo provider di modelli. Imposta privacy.egress su fail-closed in codna.yaml e Codna esegue i tuoi test solo sotto blocco di rete a livello kernel e non interroga il registro durante la revisione.
Su 87 casi appaiati contro Cursor, Codna ha usato in media 16.159 token e circa 0,02 $ di spesa modello per fix verificato, 5× meno token e 1,7× più veloce.
La mappa del repository è costruita dai pattern di import, quindi non è legata a un linguaggio. Il recall on-device copre Python, JavaScript, TypeScript, Go, Rust, Java, C, C++, C#, PHP e Ruby. Imposta fix.test_command sul tuo test runner.