Documentation · Report Bug · Discussions
X-ray vision for your agent.
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.
Built for rapid R&D and pair programming—instant answers when LSP is too slow. Learn more
curl -fsSL --proto '=https' --tlsv1.2 https://install.codanna.sh | shbrew install codannaSee Installation Guide for Cargo and other options.
codanna init
codanna index srccodanna mcp semantic_search_with_context query:"where do we handle errors" limit:3codanna documents add-collection docs ./docs
codanna documents index
codanna mcp search_documents query:"authentication flow"Your AI assistant gains structured knowledge of your code:
- "Where's this function called?" - Instant call graph, not grep results
- "Find authentication logic" - Semantic search matches intent, not just keywords
- "What breaks if I change this?" - Full dependency analysis across files
The difference: Codanna understands code structure. It knows parseConfig is a function that calls validateSchema, not just a string match.
| Feature | Description |
|---|---|
| Semantic Search | Natural language queries against code and documentation. Finds functions by what they do, not just their names. |
| Relationship Tracking | Call graphs, implementations, and dependencies. Trace how code connects across files. |
| Document Search | Index markdown and text files for RAG workflows. Query project docs alongside code. |
| MCP Protocol | Native integration with Claude, Gemini, Codex, and other AI assistants. |
| Profiles | Package hooks, commands, and agents for different project types. |
Performance: Sub-10ms lookups, 75,000+ symbols/second parsing.
Languages: Rust, Python, JavaScript, TypeScript, Java, Kotlin, Go, PHP, C, C++, C#, Swift, GDScript.
MCP protocol for AI assistants. Works with Claude Code, Cursor, Windsurf, and any MCP-compatible client. Supports stdio, HTTP, and HTTPS transports.
See Integration Guides for setup instructions.
- ~150MB for embedding model (downloaded on first use)
- Build from source: Rust 1.85+, Linux needs
pkg-config libssl-dev - Windows support is experimental
Contributions welcome. See CONTRIBUTING.md.
Apache License 2.0 - See LICENSE.
Attribution required. See NOTICE.
Built with Rust.