Search for code semantically similar to the query.

Finds code by meaning, not just text matching. Use this when you want to find code related to a concept without knowing exact variable/function names.

Examples:

• "authentication logic" - finds login, session handling, token validation

• "error handling for API calls" - finds try/except blocks, error responses

• "database connection setup" - finds connection pooling, ORM initialization

Automatically indexes the project if not already indexed, and re-indexes any files that have changed since the last search.

Args: query: Natural language description of what you're looking for. project_path: Absolute path to the project root directory. limit: Maximum number of results to return (default 10).

Returns: List of matching code chunks with file path, line numbers, content, and score.

Index a codebase for semantic search.

Scans Python files, extracts functions/classes/methods, generates embeddings, and stores them for fast semantic search.

Use force=True to re-index everything even if files haven't changed. Otherwise, only new and modified files are indexed (incremental).

Args: project_path: Absolute path to the project root directory. force: If True, re-index all files regardless of changes.

Returns: Statistics about the indexing operation.

Get the index status for a project.

Returns information about whether the project is indexed, when it was last updated, and how many files and chunks are indexed.

Note: search_code automatically re-indexes stale files before searching, so there is no need to check or act on staleness manually.

Args: project_path: Absolute path to the project root directory.

Returns: Index status including files count and chunks count.