Metadata-Version: 2.4
Name: codna
Version: 0.1.0
Summary: Local-first repo intelligence and agent fixing for Codna.
Author: Thyn
Maintainer: Thyn
License-Expression: Apache-2.0
Project-URL: Homepage, https://codna.ai
Project-URL: Documentation, https://docs.codna.ai
Project-URL: Source, https://github.com/thyn-ai/codna
Project-URL: Issues, https://github.com/thyn-ai/codna/issues
Project-URL: Security, https://codna.ai/security
Keywords: agent,ai,code-intelligence,codna,debugging,mcp,repository-intelligence,telys
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Bug Tracking
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Software Development :: Testing
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.28.0
Requires-Dist: mcp>=1.2.0
Requires-Dist: pyarrow>=15.0.0
Provides-Extra: mcp
Provides-Extra: memory
Requires-Dist: telys>=0.1.0b1; extra == "memory"
Requires-Dist: telys-runtime>=0.1.0a1; extra == "memory"
Requires-Dist: numpy>=1.24; extra == "memory"
Requires-Dist: faiss-cpu>=1.7; extra == "memory"
Requires-Dist: wordllama>=0.3; extra == "memory"
Requires-Dist: tree-sitter>=0.23; extra == "memory"
Requires-Dist: tree-sitter-javascript; extra == "memory"
Requires-Dist: tree-sitter-typescript; extra == "memory"
Requires-Dist: tree-sitter-go; extra == "memory"
Requires-Dist: tree-sitter-rust; extra == "memory"
Requires-Dist: tree-sitter-java; extra == "memory"
Requires-Dist: tree-sitter-c; extra == "memory"
Requires-Dist: tree-sitter-cpp; extra == "memory"
Requires-Dist: tree-sitter-c-sharp; extra == "memory"
Requires-Dist: tree-sitter-php; extra == "memory"
Requires-Dist: tree-sitter-ruby; extra == "memory"
Provides-Extra: memory-algenta
Requires-Dist: telys>=0.1.0b1; extra == "memory-algenta"
Requires-Dist: telys-runtime>=0.1.0a1; extra == "memory-algenta"
Requires-Dist: numpy>=1.24; extra == "memory-algenta"
Requires-Dist: faiss-cpu>=1.7; extra == "memory-algenta"
Requires-Dist: telys-algenta[algenta]>=0.1.0a1; extra == "memory-algenta"
Provides-Extra: memory-rerank
Requires-Dist: wordllama>=0.3; extra == "memory-rerank"
Provides-Extra: memory-languages
Requires-Dist: tree-sitter>=0.23; extra == "memory-languages"
Requires-Dist: tree-sitter-javascript; extra == "memory-languages"
Requires-Dist: tree-sitter-typescript; extra == "memory-languages"
Requires-Dist: tree-sitter-go; extra == "memory-languages"
Requires-Dist: tree-sitter-rust; extra == "memory-languages"
Requires-Dist: tree-sitter-java; extra == "memory-languages"
Requires-Dist: tree-sitter-c; extra == "memory-languages"
Requires-Dist: tree-sitter-cpp; extra == "memory-languages"
Requires-Dist: tree-sitter-c-sharp; extra == "memory-languages"
Requires-Dist: tree-sitter-php; extra == "memory-languages"
Requires-Dist: tree-sitter-ruby; extra == "memory-languages"

# 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

```bash
pip install codna
```

Codna supports Python 3.10 and newer on macOS and Linux.

## Common Commands

```bash
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:

```bash
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:

```bash
pip install "codna[memory]"
```

The memory extra uses Telys for on-device retrieval. Release builds can 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
