# ts-index

A powerful TypeScript code indexing and search tool with Language Server Protocol support and MCP (Model Context Protocol) integration.

## Key Features

- **Semantic Search**: Advanced code search using embeddings for natural language queries
- **Symbol Search**: Exact symbol name matching and lookup
- **LSP Integration**: Language Server Protocol support for TypeScript analysis
- **MCP Server**: Exposes indexing and search capabilities through Model Context Protocol
- **Vector Database**: SQLite-based storage with vector search capabilities
- **Multiple Transports**: Support for stdio, HTTP, and SSE communication protocols

## Technology Stack

- **TypeScript Parser**: [tree-sitter-typescript](https://github.com/tree-sitter/tree-sitter-typescript) - TypeScript and TSX grammars for tree-sitter
- **Language Server**: [yioneko/vtsls](https://github.com/yioneko/vtsls) / [typescript-language-server](https://github.com/typescript-language-server/typescript-language-server) - LSP wrapper for TypeScript
- **Vector Database**: [asg017/sqlite-vec](https://github.com/asg017/sqlite-vec) - Vector search extension for SQLite

## Usage

### Index a TypeScript project

```bash
ts-index index --project /path/to/project --db /path/to/index.db
```

### Search code semantically

```bash
ts-index search "function to parse JSON" --project /path/to/project --db /path/to/index.db
```

### Search by exact symbol name

```bash
ts-index search "parseJSON" --symbol --db /path/to/index.db
```

### Language Server Protocol commands

```bash
# Analyze symbol at position
ts-index lsp analyze src/utils.ts --project /path/to/project --line 10 --character 5

# Get code completions
ts-index lsp completion src/utils.ts --project /path/to/project --line 10 --character 5

# Search workspace symbols
ts-index lsp symbols --project /path/to/project --query "parse"

# Install language server
ts-index lsp install vtsls

# Check LSP health
ts-index lsp health
```

### Run MCP server

```bash
# stdio mode (default)
ts-index mcp --project /path/to/project --db /path/to/index.db

# HTTP mode
ts-index mcp --transport http --address :8080 --db /path/to/index.db

# SSE mode
ts-index mcp --transport sse --address :8080 --db /path/to/index.db
```

## Development

### Commands

```bash
# Run linter
make lint

# Run linter with auto-fix
make lint-fix

# Run test
make test
```

### Building

```bash
go build -o bin/ts-index ./cmd/ts-index
```