Quick Profile Install (0.6.8+):

# Initialize with latest settings
codanna init --force

# Add provider and install profile
codanna profile provider add bartolli/codanna-profiles
codanna profile install claude@codanna-profiles

# Install hook system
npm --prefix .claude/hooks/codanna install

Local customization: Clone codanna-profiles and create profiles for your project types.

See Profile Documentation for details.

Also available: Plugins - Claude Code manifest format for CC-specific workflows. See Plugin Documentation.

Your AI assistant knows your code:

• "Where's this function called?" → instant call graph
• "Show me all authentication functions" → finds functions with auth-related doc comments
• "Find config file parsers" → matches functions that parse configuration
• "What breaks if I change this interface?" → full-project impact analysis

Context is everything.

Codanna cuts the noise:

• Less grep-and-hope loops.
• Less explaining the same thing twice.
• Less blind code generation.

Instead: tight context, smarter engineering, flow that doesn't stall.

# Install
cargo install codanna --all-features

# Setup
codanna init

# Index your code
codanna index . --progress                  # Index current directory
codanna index src tests --progress          # Index specific directories
codanna add-dir src --progress              # Add directory to settings for indexing

# Ask real questions
codanna mcp semantic_search_docs query:"where do we resolve symbol references" limit:3

Result: 3 relevant functions in 0.16s with exact file locations and signatures.

• Fast parsing - Tree-sitter AST (same as GitHub code navigator)
• Semantic search - Natural language queries that understand your code
• Relationship tracking - Call graphs, implementations, dependencies
• Multi-language - Rust, Python, TypeScript, Kotlin, Go, PHP, C, C++, C#, GDScript
• MCP protocol - Native integration with Claude and other AI assistants
• Profiles - Package configs for different project types and custom workflows
• Plugins - Claude Code manifest format for project-scoped commands and agents
• <10ms lookups - Memory-mapped caches for instant responses

• Getting Started - Installation and first steps
• User Guide - CLI commands, tools, configuration
• Integrations - Claude, Codex, HTTP/HTTPS servers
• Profiles - Package hooks, commands, skills, and agents

• Advanced - Unix piping, slash commands, performance
• Architecture - How it works under the hood
• Contributing - Development setup and guidelines

• CLI Reference - All commands and options
• MCP Tools - Available MCP tools
• Configuration - Settings and customization

View all documentation →

{
  "mcpServers": {
    "codanna": {
      "command": "codanna",
      "args": ["serve", "--watch"]
    }
  }
}

1. semantic_search_with_context - Find relevant code
2. analyze_impact - Map dependencies
3. find_symbol, get_calls - Get specifics

# Build call graphs with pipes
codanna mcp find_callers index_file --json | \
jq -r '.data[]?[0] | "\(.name) - \(.file_path)"'

• Rust 1.75+ (for development)
• ~150MB for model storage (downloaded on first use)
• A few MB for index storage

Linux: sudo apt install pkg-config libssl-dev macOS: No additional dependencies

• Production ready for supported languages
• 75,000+ symbols/second parsing speed
• <10ms symbol lookups
• Windows support is experimental
• More languages coming

See CHANGELOG.md for detailed release notes.

Contributions welcome! See CONTRIBUTING.md for guidelines.

Licensed under the Apache License, Version 2.0 - See LICENSE file.

Attribution required when using Codanna in your project. See NOTICE file.

Built with 🦀 by devs throttled by tools that "understand" code only in theory.