CodePrysm

A powerful tool for analyzing code repositories and generating relationship graphs using Tree-sitter abstract syntax trees. CodePrysm transforms source code into a searchable knowledge graph, enabling semantic code search, dependency analysis, and intelligent code navigation.

Overview

CodePrysm builds a comprehensive graph representation of your codebase where:

• Nodes represent code entities using three semantic types: Container (classes, interfaces, structs), Callable (functions, methods), and Data (fields, properties, constants)
• Edges represent three types of relationships: CONTAINS (hierarchy), USES (dependencies), and DEFINES (definitions)
• Embeddings enable semantic search using natural language with full metadata support

Key Features

• Semantic Code Search - Find code using natural language queries with kind/subtype filtering
• AST-Based Analysis - Precise parsing using Tree-sitter with declarative SCM tags
• Rich Dependency Graphs - Three relationship types (CONTAINS, USES, DEFINES) for comprehensive analysis
• Fine-Grained Entities - Distinguish structs from interfaces, async from sync, fields from properties
• Scalable Architecture - Handles codebases with 100K+ files
• MCP Integration - AI-powered code exploration via Model Context Protocol
• Multi-Language - Python, JavaScript/TypeScript, C/C++, C#, Go, Rust
• GPU Acceleration - Metal (macOS) and CUDA (Linux/Windows) support

Installation

From crates.io (Recommended)

cargo install codeprysm-cli

From Source

git clone https://github.com/codeprysm/codeprysm.git
cd codeprysm
cargo build --release

GPU Acceleration (Optional)

For faster embedding generation, install with GPU support:

# macOS (Apple Silicon)
cargo install codeprysm-cli --features metal

# Linux (NVIDIA GPU)
cargo install codeprysm-cli --features cuda

Prerequisites

• Docker (for Qdrant vector database)
• Rust 1.85+ (only if building from source)

Quick Start

1. Start Qdrant (required for semantic search):

   docker run -d --name qdrant \
     -p 6333:6333 -p 6334:6334 \
     -v qdrant_storage:/qdrant/storage \
     qdrant/qdrant:latest

2. Initialize your codebase:

   cd /path/to/your/repo
   codeprysm init

3. Start the MCP server (optional, for AI assistants):

   codeprysm mcp

How It Works

graph LR
    A[Source Code] --> B[Code Graph]
    B --> C[Semantic Index]
    C --> D[MCP Server]
    D --> E[AI Assistants]

Loading

The system operates in three main phases:

1. Code Graph Generation - Parse source files into a graph structure using Tree-sitter AST
2. Indexing for Search - Create embeddings for semantic search using Qdrant
3. MCP Server Integration - Expose capabilities to AI assistants via MCP protocol

Documentation

• Getting Started - Setup guide
• Docker Setup - Running with Docker
• SCM Tag Convention - Query file syntax
• SCM Overlays - Adding scope metadata

CLI Commands

# Generate code graph
codeprysm init --root /path/to/repo

# Start MCP server
codeprysm mcp --root /path/to/repo --qdrant-url http://localhost:6334

# Search codebase
codeprysm search "function that handles authentication"

# Show statistics
codeprysm stats --codeprysm-dir .codeprysm

# Incremental update
codeprysm update --root /path/to/repo

Supported Languages

Language	Containers	Callables	Data
Python	Classes, modules	Functions, methods, async	Fields, constants
JavaScript/TypeScript	Classes, interfaces, enums	Functions, methods, constructors	Fields, properties
C/C++	Structs, classes, enums, namespaces	Functions, methods	Fields, enum constants
C#	Classes, structs, interfaces, enums	Methods, constructors	Fields, properties
Go	Structs, interfaces	Functions, methods	Fields
Rust	Structs, enums, traits	Functions, methods, async	Fields, const values

Performance & Scalability

Codebase Size	Files	Processing Time	Memory Usage
Small	<1K	<1 min	<1 GB
Medium	1K-10K	1-5 min	1-4 GB
Large	10K-50K	5-20 min	4-16 GB
Very Large	50K-100K	20-60 min	16-32 GB

Development

For development, install just command runner:

# Build
just rust-build

# Test
just rust-test

# Lint
just rust-lint

# Format
just rust-fmt

See CONTRIBUTING.md for detailed development guidelines.

Project Structure

codeprysm/
├── crates/
│   ├── codeprysm-core/     # Graph generation, tree-sitter parsing
│   ├── codeprysm-search/   # Vector search, embeddings
│   ├── codeprysm-mcp/      # MCP server
│   ├── codeprysm-cli/      # Command-line interface
│   ├── codeprysm-config/   # Configuration management
│   └── codeprysm-backend/  # Backend abstraction
├── tests/fixtures/         # Test repositories
├── docs/                   # Documentation
└── docker/                 # Docker configuration

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Tree-sitter for powerful parsing capabilities
• Qdrant for vector search
• Candle for ML inference