xray

[](https://python.org) [](https://modelcontextprotocol.io) [](https://ast-grep.github.io)

AI assistants struggle with codebase understanding. You get:

• ❌ "I can't see your code structure"
• ❌ "I don't know what depends on this function"
• ❌ Generic refactoring advice without impact analysis
• ❌ No understanding of symbol relationships

XRAY gives AI assistants code navigation capabilities. Add use XRAY tools to your prompt:

Analyze the UserService class and show me what would break if I change the authenticate method. use XRAY tools

Find all functions that call validate_user and show their dependencies. use XRAY tools

XRAY provides three focused tools:

• 🗺️ Map (explore_repo) - See project structure with symbol skeletons
• 🔍 Find (find_symbol) - Locate functions and classes with fuzzy search
• 💥 Impact (what_breaks) - Find where a symbol is referenced

# Install uv if you don't have it
curl -LsSf https://astral.sh/uv/install.sh | sh

# Clone and install XRAY
git clone https://github.com/srijanshukla18/xray.git
cd xray
uv tool install .

For the quickest setup, this script automates the uv installation process.

curl -fsSL https://raw.githubusercontent.com/srijanshukla18/xray/main/install.sh | bash

# Get config for your tool
python mcp-config-generator.py cursor local_python
python mcp-config-generator.py claude docker  
python mcp-config-generator.py vscode source

XRAY uses ast-grep, a tree-sitter powered structural search tool, providi