codanna

Name: codanna
Author: bartolli

bybartolli· 1 MCP server

Stars

712

Forks

How to install codanna?

bartolli/codanna

$git clone https://github.com/bartolli/codanna

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Install & use

Install codanna by running `git clone https://github.com/bartolli/codanna`, then use it for the current task and follow its documentation at https://github.com/bartolli/codanna.

Files · 1

View on GitHub

README.md

1	<div align="center">
2
3	<h1 align="center">Codanna</h1>
4
5	[![Claude](https://img.shields.io/badge/Claude-✓%20Compatible-grey?logo=claude&logoColor=fff&labelColor=D97757)](#)
6	[![Google Gemini](https://img.shields.io/badge/Gemini-✓%20Compatible-grey?logo=googlegemini&logoColor=fff&labelColor=8E75B2)](#)
7	[![OpenAI Codex](https://img.shields.io/badge/Codex-✓%20Compatible-grey?logo=openai&logoColor=fff&labelColor=10A37F)](#)
8	[![Rust](https://img.shields.io/badge/Rust-CE412B?logo=rust&logoColor=white)](#)
9	[![Crates.io Total Downloads](https://img.shields.io/crates/d/codanna?logo=rust&labelColor=CE412B&color=grey)](#)
10
11	<p align="center">
12	<a href="https://docs.codanna.sh/" target="_blank">Documentation</a>
13	·
14	<a href="https://github.com/bartolli/codanna/issues">Report Bug</a>
15	·
16	<a href="https://github.com/bartolli/codanna/discussions">Discussions</a>
17	</p>
18
19	<h2></h2>
20
21	X-ray vision for your agent.
22
23	Give your code assistant the ability to see through your codebase—understanding functions, tracing relationships, and finding implementations with surgical precision. Context-first coding. No grep-and-hope loops. No endless back-and-forth. Just smarter engineering in fewer keystrokes.
24
25	Built for rapid R&D and pair programming—instant answers when LSP is too slow. [Learn more](https://docs.codanna.sh/)
26	</div>
27
28	<h3 align="left"></h3>
29
30	## Quick Start
31
32	### Install (macOS, Linux, WSL)
33
34	```bash
35	curl -fsSL --proto '=https' --tlsv1.2 https://install.codanna.sh \| sh
36	```
37
38	### Or via Homebrew
39
40	```bash
41	brew install codanna
42	```
43
44	### Or via Nix
45
46	```bash
47	nix run github:bartolli/codanna
48	```
49
50	### Windows (PowerShell)
51	```powershell
52	irm https://raw.githubusercontent.com/bartolli/codanna/main/scripts/install.ps1 \| iex
53	```
54
55	See [Installation Guide](https://docs.codanna.sh/installation) for Cargo and other options.
56
57	### Initialize and index
58
59	```bash
60	codanna init
61	codanna index src
62	```
63
64	### Search code
65
66	```bash
67	codanna mcp semantic_search_with_context query:"where do we handle errors" limit:3
68	```
69
70	### Search documentation (RAG)
71
72	```bash
73	codanna documents add-collection docs ./docs
74	codanna documents index
75	codanna mcp search_documents query:"authentication flow"
76	```
77
78	## What It Does
79
80	Your AI assistant gains structured knowledge of your code:
81
82	- "Where's this function called?" - Instant call graph, not grep results
83	- "Find authentication logic" - Semantic search matches intent, not just keywords
84	- "What breaks if I change this?" - Full dependency analysis across files
85
86	The difference: Codanna understands code structure. It knows `parseConfig` is a function that calls `validateSchema`, not just a string match.
87
88	## Features
89
90	\| Feature \| Description \|
91	\|---------\|-------------\|
92	\| [Semantic Search](https://docs.codanna.sh/features/semantic-search) \| Natural language queries against code and documentation. Finds functions by what they do, not just their names. \|
93	\| [Relationship Tracking](https://docs.codanna.sh/features/relationships) \| Call graphs, implementations, and dependencies. Trace how code connects across files. \|
94	\| [Document Search](https://docs.codanna.sh/features/document-search) \| Index markdown and text files for RAG workflows. Query project docs alongside code. \|
95	\| [MCP Protocol](https://docs.codanna.sh/reference/mcp-quick) \| Native integration with Claude, Gemini, Codex, and other AI assistants. \|
96	\| [Profiles](https://docs.codanna.sh/features/collaboration) \| Package hooks, commands, and agents for different project types. \|
97
98	Performance: Sub-10ms lookups, 75,000+ symbols/second parsing.
99
100	Languages: Rust, Python, JavaScript, TypeScript, Java, Kotlin, Go, PHP, C, C++, C#, Clojure, Lua, Swift, GDScript.
101
102	## Integration
103
104	MCP protocol for AI assistants. Works with Claude Code, Cursor, Windsurf, and any MCP-compatible client. Supports stdio, HTTP, and HTTPS transports.
105
106	See [Integration Guides](https://docs.codanna.sh/reference/mcp-quick) for setup instructions.
107
108	## Requirements
109
110	- ~150MB for embedding model (downl

6 picks

Type

codanna

bybartolli· 1 MCP server

Stars

712

Forks

How to install codanna?

bartolli/codanna

$git clone https://github.com/bartolli/codanna

Installs into the current project.

›Prefer a prompt? Paste this to your agent

Install & use

Install codanna by running `git clone https://github.com/bartolli/codanna`, then use it for the current task and follow its documentation at https://github.com/bartolli/codanna.

Files · 1

View on GitHub

README.md

1	<div align="center">
2
3	<h1 align="center">Codanna</h1>
4
5	[![Claude](https://img.shields.io/badge/Claude-✓%20Compatible-grey?logo=claude&logoColor=fff&labelColor=D97757)](#)
6	[![Google Gemini](https://img.shields.io/badge/Gemini-✓%20Compatible-grey?logo=googlegemini&logoColor=fff&labelColor=8E75B2)](#)
7	[![OpenAI Codex](https://img.shields.io/badge/Codex-✓%20Compatible-grey?logo=openai&logoColor=fff&labelColor=10A37F)](#)
8	[![Rust](https://img.shields.io/badge/Rust-CE412B?logo=rust&logoColor=white)](#)
9	[![Crates.io Total Downloads](https://img.shields.io/crates/d/codanna?logo=rust&labelColor=CE412B&color=grey)](#)
10
11	<p align="center">
12	<a href="https://docs.codanna.sh/" target="_blank">Documentation</a>
13	·
14	<a href="https://github.com/bartolli/codanna/issues">Report Bug</a>
15	·
16	<a href="https://github.com/bartolli/codanna/discussions">Discussions</a>
17	</p>
18
19	<h2></h2>
20
21	X-ray vision for your agent.
22
23	Give your code assistant the ability to see through your codebase—understanding functions, tracing relationships, and finding implementations with surgical precision. Context-first coding. No grep-and-hope loops. No endless back-and-forth. Just smarter engineering in fewer keystrokes.
24
25	Built for rapid R&D and pair programming—instant answers when LSP is too slow. [Learn more](https://docs.codanna.sh/)
26	</div>
27
28	<h3 align="left"></h3>
29
30	## Quick Start
31
32	### Install (macOS, Linux, WSL)
33
34	```bash
35	curl -fsSL --proto '=https' --tlsv1.2 https://install.codanna.sh \| sh
36	```
37
38	### Or via Homebrew
39
40	```bash
41	brew install codanna
42	```
43
44	### Or via Nix
45
46	```bash
47	nix run github:bartolli/codanna
48	```
49
50	### Windows (PowerShell)
51	```powershell
52	irm https://raw.githubusercontent.com/bartolli/codanna/main/scripts/install.ps1 \| iex
53	```
54
55	See [Installation Guide](https://docs.codanna.sh/installation) for Cargo and other options.
56
57	### Initialize and index
58
59	```bash
60	codanna init
61	codanna index src
62	```
63
64	### Search code
65
66	```bash
67	codanna mcp semantic_search_with_context query:"where do we handle errors" limit:3
68	```
69
70	### Search documentation (RAG)
71
72	```bash
73	codanna documents add-collection docs ./docs
74	codanna documents index
75	codanna mcp search_documents query:"authentication flow"
76	```
77
78	## What It Does
79
80	Your AI assistant gains structured knowledge of your code:
81
82	- "Where's this function called?" - Instant call graph, not grep results
83	- "Find authentication logic" - Semantic search matches intent, not just keywords
84	- "What breaks if I change this?" - Full dependency analysis across files
85
86	The difference: Codanna understands code structure. It knows `parseConfig` is a function that calls `validateSchema`, not just a string match.
87
88	## Features
89
90	\| Feature \| Description \|
91	\|---------\|-------------\|
92	\| [Semantic Search](https://docs.codanna.sh/features/semantic-search) \| Natural language queries against code and documentation. Finds functions by what they do, not just their names. \|
93	\| [Relationship Tracking](https://docs.codanna.sh/features/relationships) \| Call graphs, implementations, and dependencies. Trace how code connects across files. \|
94	\| [Document Search](https://docs.codanna.sh/features/document-search) \| Index markdown and text files for RAG workflows. Query project docs alongside code. \|
95	\| [MCP Protocol](https://docs.codanna.sh/reference/mcp-quick) \| Native integration with Claude, Gemini, Codex, and other AI assistants. \|
96	\| [Profiles](https://docs.codanna.sh/features/collaboration) \| Package hooks, commands, and agents for different project types. \|
97
98	Performance: Sub-10ms lookups, 75,000+ symbols/second parsing.
99
100	Languages: Rust, Python, JavaScript, TypeScript, Java, Kotlin, Go, PHP, C, C++, C#, Clojure, Lua, Swift, GDScript.
101
102	## Integration
103
104	MCP protocol for AI assistants. Works with Claude Code, Cursor, Windsurf, and any MCP-compatible client. Supports stdio, HTTP, and HTTPS transports.
105
106	See [Integration Guides](https://docs.codanna.sh/reference/mcp-quick) for setup instructions.
107
108	## Requirements
109
110	- ~150MB for embedding model (downl

6 picks

Type

codanna

How to install codanna?

Related

codanna

How to install codanna?

Related