@emtai/xray-index

Local codebase indexer for XRay-Vision. Extracts code structure (functions, classes, imports, call graphs) and uploads to the XRay-Vision server for analysis.

Quick Start

npx @emtai/xray-index /path/to/your/repo --upload --token YOUR_API_KEY

Usage

xray-index <repo-path> [options]

Options

| Option | Description | Default | |--------|-------------|---------| | --upload | Upload results to XRay-Vision server | off | | --token <token> | API key for upload authentication | - | | --server <url> | XRay-Vision server URL | https://emtai-xray.emtailabs.com | | --shadow-path <path> | Custom shadow copy location | ~/.xray-vision/shadows | | --skip-shadow-prompt | Skip shadow copy confirmation | off | | --output <file> | Save results to file instead of uploading | - | | -v, --verbose | Verbose output | off |

How It Works

1. Shadow copy - Creates a safe copy of your codebase (excluding node_modules, .git, etc.)
2. Extraction - Parses TypeScript/JavaScript/Python/Go/Rust/Java files to extract functions, classes, imports, and call relationships
3. Upload - Sends the extracted data to XRay-Vision for graph-based analysis

Examples

Index and upload

npx @emtai/xray-index ./my-project --upload --token xray-abc123

Index and save locally

npx @emtai/xray-index ./my-project --output analysis.json

Custom server

npx @emtai/xray-index ./my-project --upload --token xray-abc123 --server https://your-server.com

Get an API Key

Get your API key from the XRay-Vision dashboard under Settings > API Keys.

Requirements

• Node.js >= 18.0.0