semantic-search

Searches code, docs, symbols, git history, and implementation concepts by meaning with the semantic_search tool. Use when locating where behavior is implemented, tracing a feature across files, finding callers/usages by description, or asking why/when code changed.

Find code, docs, and symbols by meaning across the whole project. Use when you need to locate where something is implemented, trace a feature, behavior, or concept across files, understand an unfamiliar codebase, find all callers or usages, search by description ("where do we handle retries", "find the auth middleware"), or ask why/when something changed. Use the single semantic_search tool instead of multiple grep and read calls — it returns ranked file-and-line snippets in one call and uses far less context.