# Codna

## Codna

- [Overview](https://docs.codna.ai/getting-started/readme.md): Codna understands a repository before it acts. It maps the code for about zero model tokens, then fixes, reviews and secures from the evidence. Runs on your machine or your cloud.
- [Installation](https://docs.codna.ai/getting-started/installation.md): Install the codna CLI from PyPI with one pip command. No Node, Bun, Docker, or separate engine.
- [Quickstart](https://docs.codna.ai/getting-started/quickstart.md): Install the Codna CLI, add a model key, triage a repository, and open an automated fix PR.
- [codna review](https://docs.codna.ai/guides/review.md): codna review reads a pull request, posts findings with severity, category and confidence, approves a clean diff, and names a red required check next to its verdict.
- [Security Autofix](https://docs.codna.ai/guides/security-autofix.md): Prove which scanner findings are reachable, remediate only the eligible ones, and open a draft PR only when every safety condition holds.
- [Hooks](https://docs.codna.ai/guides/hooks.md): Hooks — lifecycle scripts that observe, block or annotate an agent turn, in .codna/hooks.json or a Cursor .cursor/hooks.json, which events run, and what an unsupported event does.
- [MCP Server](https://docs.codna.ai/guides/mcp.md): Run Codna as a Model Context Protocol server so Cursor, Claude Desktop, or your own agent can triage, fix, secure, recall code, and file reports.
- [GitHub Action](https://docs.codna.ai/guides/github-action.md): thyn-ai/codna-action@v1 runs codna fix, review or secure from your own CI. It installs codna from PyPI and runs the same commands you run on your machine.
- [GitHub App](https://docs.codna.ai/guides/github-app.md): Install the Codna GitHub App. It reviews every pull request, answers @codna review and @codna fix, fixes red CI on a PR, proves scanner findings, and reports on merge-queue commits.
- [How It Works](https://docs.codna.ai/concepts/concepts.md): How Codna maps a repository deterministically for zero tokens, then hands an agent a tight evidence bundle to produce a fix with a measured regression risk.
- [Privacy and data](https://docs.codna.ai/concepts/privacy.md): What leaves your machine when Codna runs, what never does, where keys live, and the privacy controls in codna.yaml.
- [Models & BYOK](https://docs.codna.ai/concepts/models-and-byok.md): Your model provider key (BYOK) vs. your Codna account key, where keys are stored, and how to pin a model in codna.yaml.
- [Code Memory](https://docs.codna.ai/concepts/memory.md): Codna's on-device code memory. A local semantic index of your repository, powered by the bundled Telys kernel. Offline and zero-configuration after a one-time free \`codna login\`.
- [Language support](https://docs.codna.ai/concepts/languages.md): Repository understanding is language-agnostic. On-device code memory uses a fixed set of tree-sitter grammars. Which one applies depends on the feature.
- [CLI Reference](https://docs.codna.ai/reference/cli.md): Complete reference for every Codna CLI command, its flags, and usage.
- [Configuration](https://docs.codna.ai/reference/configuration.md): Environment variables Codna reads for model keys, GitHub writes, the local runtime, code memory and security autofix, and the codna.yaml file with its model, privacy, fix and review blocks.
- [CI fleet gate](https://docs.codna.ai/reference/adaptive-concurrency.md): codna ci keeps a self-hosted CI runner fleet inside a chosen share of one machine. A job asks for a slot before it does real work. The gate never fails a build.
- [Local runtime](https://docs.codna.ai/reference/operations.md): Operate Codna's local runtime. Health checks, the full diagnostic, loopback ports, and the environment variables that control on-disk state.
- [Troubleshooting](https://docs.codna.ai/reference/troubleshooting.md): Fix the common Codna errors. A missing model key, a local runtime that did not start, a missing flag, or a GitHub App check that ended neutral.
- [Glossary](https://docs.codna.ai/reference/glossary.md): Plain-language definitions of the terms you'll see across Codna's docs and output. Snapshots, evidence bundles, blast radius, review verdicts, reachability verdicts, the G-gates, and more.
- [FAQ](https://docs.codna.ai/reference/faq.md): Short answers about offline use, where your code goes, cost, languages, pull-request commands, review verdicts, and private repositories.
- [Changelog](https://docs.codna.ai/reference/changelog.md): What's new in Codna. The capabilities and fixes as they ship, newest first.