codna 0.1.3

Local-first repo intelligence and agent fixing for Codna.

Codna CLI

Codna is a local-first code intelligence and fixing CLI. It maps a repository, builds focused evidence for the agent, applies patches through the local Codna runtime, and reports verification evidence without requiring users to manage a separate local database or engine stack.

Install

pip install codna

Codna supports Python 3.10 and newer on macOS and Linux.

Common Commands

codna doctor
codna doctor --start-stack
codna triage .
codna fix . --issue "describe the failing test or production bug"
codna mcp

codna doctor is read-only by default. codna doctor --start-stack starts the owned local runtime when you explicitly ask for it. Normal fix and benchmark paths use the same runtime contract.

What Codna Runs Locally

The base install includes the local Arrow/Parquet artifact dependency required for repository-intelligence step history. Clean installs include a packaged local repository backend for snapshot, triage, sidecar-backed fix planning, deterministic patch simulation, and explicit local-branch apply.

Codna's normal local product path uses the local Algenta SDK/core in process for repository intelligence. No local Postgres is required. Local runtime state is kept under the user's Codna runtime directory, and the agent sidecar is started only when needed.

MCP

Codna can run as a local MCP server for editors and agents that support MCP:

codna mcp

Use this when Cursor, Claude, or another MCP-compatible client needs Codna's repo understanding as a local tool.

Optional Local Memory

Optional local code-memory support is available through:

pip install "codna[memory]"

The memory extra uses the public Telys SDK for on-device retrieval. It installs public Python dependencies only; the signed native runtime is installed separately:

telys runtime install --file <bundle> --license <license.jwt>

Codna also supports release builds that include signed native Telys runtime artifacts for supported platforms. Source distributions intentionally exclude bundled native runtime artifacts.

Security And Local Files

Codna is designed for local-first operation:

• Secrets are never required in source control.
• Local runtime state and logs stay on the user's machine.
• Generated release artifacts are not included in source distributions.
• Secrets, local runtime state, logs, .env files, key files, and bundled native runtime artifacts are excluded from source distributions.

Links

• Homepage: https://codna.ai
• Documentation: https://docs.codna.ai
• Source: https://github.com/thyn-ai/codna
• Security: https://codna.ai/security