Installation

Codanna is a local code intelligence MCP server and CLI for AI coding agents. Install on macOS, Linux, Windows (WSL), or Nix; initialize and index your first project below.

Install

Native
Homebrew
Cargo
Nix

curl -fsSL --proto '=https' --tlsv1.2 https://install.codanna.sh | sh

Works on macOS, Linux, and WSL. Downloads pre-built binary.

brew install codanna

Works on macOS and Linux.

# From crates.io
cargo install codanna --locked

# Prebuilt binaries (faster)
cargo binstall codanna

Requires cargo-binstall for prebuilt binaries.

# Run directly
nix run github:bartolli/codanna

# Development shell
nix develop github:bartolli/codanna

Requires Nix with flakes enabled.

Quick Start

Initialize

Navigate to your project and run:

codanna init

Index your code

codanna index .

codanna mcp semantic_search_with_context query:"where do we handle errors" limit:3

Connecting AI assistants: Configure your MCP client to spawn the server automatically.See MCP Persistent for stdio setup (Claude Code, Cursor, etc.) or MCP Network for HTTP/HTTPS.

Overview

Features

Workflows

Install

Quick Start

Next Steps

Semantic Search

Tool Tiers

​Install

​Quick Start

​Next Steps

Semantic Search

Tool Tiers

Install

Quick Start

Next Steps