AI Code Context VSCode Extension

A code indexing and semantic search VSCode extension powered by Code Context.

📖 New to Code Context? Check out the main project README for an overview and setup instructions.

Features

• 🔍 Semantic Search: Intelligent code search based on semantic understanding, not just keyword matching
• 📁 Codebase Indexing: Automatically index entire codebase and build semantic vector database
• 🎯 Context Search: Search related code by selecting code snippets
• 🔧 Multi-platform Support: Support for OpenAI, VoyageAI, Gemini, and Ollama as embedding providers
• 💾 Local Vector Storage: Uses sqlite-vec for efficient local vector storage (no cloud required)

Requirements

• VSCode Version: 1.74.0 or higher

Installation

From VS Code Marketplace

1. Direct Link: Install from VS Code Marketplace

2. Manual Search:

   • Open Extensions view in VSCode (Ctrl+Shift+X or Cmd+Shift+X on Mac)
   • Search for "AI Code Context"
   • Click Install

Quick Start

Configuration

The first time you open Code Context, you need to click on Settings icon to configure the relevant options.

Embedding Configuration

Configure your embedding provider to convert code into semantic vectors.

OpenAI Configuration:

• Embedding Provider: Select "OpenAI" from the dropdown
• Model name: Choose the embedding model (e.g., text-embedding-3-small, text-embedding-3-large)
• OpenAI API key: Your OpenAI API key for authentication
• Custom API endpoint URL: Optional custom endpoint (defaults to https://api.openai.com/v1)

Other Supported Providers:

• Gemini: Google's state-of-the-art embedding model with Matryoshka representation learning
• VoyageAI: Alternative embedding provider with competitive performance
• Ollama: For local embedding models

Code Splitter Configuration

Configure how your code is split into chunks for indexing.

Splitter Settings:

• Splitter Type: Choose between "AST Splitter" (syntax-aware) or "LangChain Splitter" (character-based)
• Chunk Size: Maximum size of each code chunk (default: 1000 characters)
• Chunk Overlap: Number of overlapping characters between chunks (default: 200 characters)

Recommendation: Use AST Splitter for better semantic understanding of code structure.

Vector Database Configuration

Code Context uses sqlite-vec for local vector storage by default. The database is stored at ~/.code-context/vectors/.

You can optionally configure a custom path:

• Vector DB Path: Custom directory path for vector database storage

Usage

1. Set the Configuration:

   • Open VSCode Settings (Ctrl+, or Cmd+, on Mac)
   • Search for "Code Context"
   • Set the configuration

2. Index Codebase:

   • Open Command Palette (Ctrl+Shift+P or Cmd+Shift+P on Mac)
   • Run "Code Context: Index Codebase"

3. Start Searching:

   • Open Code Context panel in sidebar
   • Enter search query or right-click on selected code to search

Commands

• Code Context: Semantic Search - Perform semantic search
• Code Context: Index Codebase - Index current codebase
• Code Context: Clear Index - Clear the index

Configuration

• semanticCodeSearch.embeddingProvider.provider - Embedding provider (OpenAI/VoyageAI/Gemini/Ollama)
• semanticCodeSearch.embeddingProvider.model - Embedding model to use
• semanticCodeSearch.embeddingProvider.apiKey - API key for embedding provider
• semanticCodeSearch.embeddingProvider.baseURL - Custom API endpoint URL (optional, for OpenAI and Gemini)
• semanticCodeSearch.embeddingProvider.outputDimensionality - Output dimension for Gemini (supports 3072, 1536, 768, 256)
• semanticCodeSearch.vectorDb.dbPath - Custom path for vector database storage (optional)

Contributing

This VSCode extension is part of the Code Context monorepo. Please see:

• Main Contributing Guide - General contribution guidelines
• VSCode Extension Contributing - Specific development guide for this extension

Related Packages

• @tan-yong-sheng/code-context-core - Core indexing engine used by this extension
• @tan-yong-sheng/code-context-mcp - Alternative MCP server integration

Tech Stack

• TypeScript
• VSCode Extension API
• sqlite-vec (local vector database)
• OpenAI/VoyageAI/Gemini/Ollama Embeddings

License

MIT - See LICENSE for details