codanna

Name: codanna
Author: bartolli

711stars65forks

How to install codanna?

bartolli/codanna

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

Installs into the current project.

Summary

X-ray vision for your agent.

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

People who liked this also viewed

6 picks

Type

fastapi_mcpExpose your FastAPI endpoints as Model Context Protocol (MCP) tools, with Auth!MCP ServersNov 202519M12k
lean-lsp-mcpLean Theorem Prover MCPMCP ServersJul 20261.9M454
rulesyncA Utility CLI for AI Coding AgentsMCP ServersJul 2026889k1.3k
FunASROpen-source speech recognition toolkit for training, inference, streaming ASR, VAD, punctuation, speaker diarization pipelines, and OpenAI-compatible/MCP serving.MCP ServersJul 2026443k19k
repomix📦 Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Language Models (LLMs) or other AI tools like Claude, ChatGPT, DeepSeek, Perplexity, Gemini, Gemma, Llama, Grok, and more.MCP ServersJul 2026310k27k
mcp-serverMCP server for AI-assisted development of CAP applicationsMCP ServersJul 2026295k105

codanna

711stars65forks

View on GitHub

How to install codanna?

bartolli/codanna

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

Installs into the current project.

Summary

X-ray vision for your agent.

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

People who liked this also viewed

6 picks

Type