codanna 0.8.2 - Docs.rs

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.

[!NOTE] New Feature: Profiles! Package hooks, commands, skills, and agents for different project types and custom workflows. More control than plugins, not tied to Claude Code manifest.

The claude profile includes Research-Agent (renamed from codanna-navigator), /codanna:x-ray and /codanna:symbol commands, and hooks for read size limits and skill suggestions.

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.

What It Solves

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

Why Bother

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.

Quick Start

# 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.

Features

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, JavaScript, TypeScript, Java, 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

Documentation

Learn

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

Master

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

Reference

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

View all documentation →

Integration Examples

Claude Code

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

Agent Workflow

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

Unix Native

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

Requirements

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

System Dependencies

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

Current Status

12 supported languages with tree-sitter parsing
75,000+ symbols/second parsing speed
<10ms symbol lookups
Windows support is experimental

Releases

See CHANGELOG.md for detailed release notes.

Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

License

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.