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
Base pip install codna includes Codna's local Telys recall path: the public
Telys SDK, Codna's vendored local runtime package, and release-wheel native
runtime artifacts for supported platforms. It also includes the generic
tree-sitter language extractors used by local Telys recall for JS/TS, Go, Rust,
Java, C/C++, C#, PHP, and Ruby; Python uses the stdlib AST extractor.
The optional codna[memory] extra adds heavier recall enhancements such as
FAISS and WordLlama reranking. It is not required for basic on-device recall.
Source distributions intentionally exclude bundled native runtime artifacts and
OEM licenses; platform wheels carry them at release time. 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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file codna-0.1.18.tar.gz.
File metadata
- Download URL: codna-0.1.18.tar.gz
- Upload date:
- Size: 3.4 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f4bd56eaf70d0de5af171dceb5fd0506b6647775d28adc95ff968503e7a161f9
|
|
| MD5 |
42780d80b8e72afe4555e62e0b9e41c6
|
|
| BLAKE2b-256 |
457d81658da75d1ee96a69f9dcfadce4dee80a515d2820d1239f7dda0740afa7
|
File details
Details for the file codna-0.1.18-py3-none-manylinux_2_34_x86_64.whl.
File metadata
- Download URL: codna-0.1.18-py3-none-manylinux_2_34_x86_64.whl
- Upload date:
- Size: 22.9 MB
- Tags: Python 3, manylinux: glibc 2.34+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3b5d838310ba290cfd7b0e4f689fb28bcc7f738b50f1eda2caba9a878fa3db37
|
|
| MD5 |
f736cc5760f6bcfbdb07a6fdf5e63bd5
|
|
| BLAKE2b-256 |
7c701e006268aa1502331b1c444f19476fb1cca8a9a7d52155118ebfdb663303
|
File details
Details for the file codna-0.1.18-py3-none-macosx_14_0_arm64.whl.
File metadata
- Download URL: codna-0.1.18-py3-none-macosx_14_0_arm64.whl
- Upload date:
- Size: 4.5 MB
- Tags: Python 3, macOS 14.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.13.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6fd9586212524fb3b8486172f0d65447d8cb2ff51bee672e5f5a756344907be0
|
|
| MD5 |
d9d74159239c74c35328352e053b87aa
|
|
| BLAKE2b-256 |
34732f4e18003854ba7b884e20237446745b711a89cced242c4694cae1774cf1
|
