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.
Local Memory And Telys
The base Codna install includes local code-memory support and the packaged Telys SDK/runtime/license:
pip install codna
Users install Codna once. There is no separate user-facing Telys publishing,
download, license, or install step. The optional codna[memory] extra only
adds heavier retrieval/rerank/language packages for experiments; it is not
required for the default Codna + Telys runtime path. Source distributions
intentionally exclude bundled native runtime artifacts; source checkout and
unsupported-platform development can point Codna at an explicit runtime with
TELYS_KERNEL or CODNA_TELYS_INSTALL_ROOT.
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,
.envfiles, 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
1 maintainer
Release files for codna 0.2.18
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| codna-0.2.18.tar.gz | 3.5 MB | Details |
Built distributions (wheels)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| codna-0.2.18-py3-none-manylinux_2_28_x86_64.whl | Python 3 | none | Linux glibc 2.28+ x86-64 | Details |
| codna-0.2.18-py3-none-macosx_14_0_arm64.whl | Python 3 | none | macOS 14.0+ ARM64 | Details |
Total release size: 97.0 MB
Release files / codna-0.2.18.tar.gz
| Download URL | codna-0.2.18.tar.gz |
|---|---|
| Size | 3.5 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
daece849c8a2e0cdb80f0e86e073dae5633f305192591f1121facaddda0f4fc5
|
|
BLAKE2b-256 checksum How to use checksums |
e846565051e0987320002635ab0f5f31784f637564cce4730c9e1484bd047c70
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / codna-0.2.18-py3-none-manylinux_2_28_x86_64.whl
| Download URL | codna-0.2.18-py3-none-manylinux_2_28_x86_64.whl |
|---|---|
| Size | 64.0 MB |
| Tags | Linux glibc 2.28+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
5ec8bf1a3e0a5aed5fa65588aec1256dda622e9bc240ee90c180987d4db8d579
|
|
BLAKE2b-256 checksum How to use checksums |
6ef089a268cd52712bae770f31e4ac8c47e710c8a5f9778553206d3a24f4b06d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
Release files / codna-0.2.18-py3-none-macosx_14_0_arm64.whl
| Download URL | codna-0.2.18-py3-none-macosx_14_0_arm64.whl |
|---|---|
| Size | 29.5 MB |
| Tags | Python 3 macOS 14.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
afe8c12c2e108e9be5d54dcc2cb508ec900449679ea8939c71b5ff32d2a21362
|
|
BLAKE2b-256 checksum How to use checksums |
78045cc79aa2fcf8316df2679337d47bf66f8707b53b280508a9992f101d35f5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.7
|
