Search indexed files using semantic or hybrid search.

Args: query: Natural language query. n_results: Optional number of results to return (default: 10).

Search indexed files, restricting results to paths matching a pattern.

Args: query: Natural language query. file_pattern: Glob-style pattern or substring for file paths (e.g. '.py', 'models/'). n_results: Optional number of results to return (default: 10).

Get statistics about the current index.

Returns chunk count, collection name, storage mode, and embedding provider. Use this to verify the index is loaded and check its size.

Manually trigger indexing of the current working directory.

Auto-indexes on first search, so you rarely need this. By default, does incremental indexing (only changed files). Use force=True to do a full re-index from scratch.

Args: force: If True, full re-index. If False, incremental update. include_extensions: Optional list of file extensions to include (e.g. [".py", ".ts", "js"]). When provided, ONLY files with these extensions are indexed; the default TEXT_EXTENSIONS allowlist is replaced. Leading dots are optional. exclude_extensions: Optional list of file extensions to exclude (e.g. [".txt", ".md"]). Files with these extensions are skipped even if they would otherwise be indexed. Leading dots are optional.

Check whether the index for the current directory is up to date.

Call this FIRST if you're unsure whether to use semantic search or fall back to file-by-file reading. Returns whether the directory is indexed and whether there are local changes that might make the index stale.

Get a compressed overview of the indexed directory structure.

Returns language breakdown, directory structure, key files, and dependency information. Use this FIRST when starting work on an unfamiliar directory to understand its layout before searching for specific content.

Much cheaper than reading files individually — gives you the big picture in one call.

Get function and class signatures from files matching a path.

Use this to understand the API surface of a module without reading every file. Returns function names, parameters, return types, and class hierarchies.

More structured than semantic search — gives you the exact interface of code modules.

Args: file_path: Substring to match in file paths (case-insensitive). E.g. "models", "api/routes", ".py", "utils". Empty string matches all files.

Get the import/dependency graph for the codebase.

Shows which files import from which other files within the project. Use this to understand module boundaries and find the right place to make changes.

Args: file_pattern: Optional substring to filter files (case-insensitive). Empty string analyzes the entire project.

[Deprecated: use 'search'] Semantic search over indexed files.

[Deprecated: use 'search_by_file'] Search filtered by file pattern.

[Deprecated: use 'get_context'] Get directory overview.

[Deprecated: use 'stats'] Get index statistics.

[Deprecated: use 'ingest'] Manually trigger indexing.

[Deprecated: use 'check_status'] Check index freshness.