local-rag

Show the current MCP server configuration: resolved project directory, database location, index status, embedding model, active config, and all currently connected databases.

Show search usage analytics: query counts, zero-result queries, low-relevance queries, top searched terms.

Attach a persistent note to a file or symbol that surfaces inline in future read_relevant results. Call this immediately when you encounter: a known bug or race condition, fragile code that shouldn't be changed yet, a non-obvious architectural constraint, or a workaround that needs context. Calling …

Retrieve persistent notes attached to files or symbols. Pass path to get all notes for a file. Pass query to search semantically across all annotations. Pass both to filter by file and rank by relevance.

Remove an annotation that is no longer relevant — e.g. a bug that was fixed, a constraint that no longer applies, or a note on a deleted file/symbol. Use get_annotations first to find the annotation ID.

Save a checkpoint so future sessions know what was done and why. REQUIRED: call this as your final step after completing any user-requested task, before responding to the user. Also call when hitting a blocker or changing direction mid-task.

List conversation checkpoints, most recent first. Cross-session by default.

Semantic search over checkpoint titles and summaries.

Search through conversation history. Finds past decisions, discussions, and tool outputs from current or previous sessions.

Read the full verbatim text of past conversation turns by session + turn index. The read counterpart to search_conversation, which only returns short snippets — use it to hydrate a turn you located, or to pull a range of recent turns. Set includeToolOutput to also get tool results (re-parses the raw…

Semantically search git commit history. Use this to find why code was changed, when decisions were made, or what an author worked on. Returns commits ranked by relevance to the query.

Files that historically change in the same commit as a given file — logical coupling the import graph can't see (doc↔code, test↔impl, synced mirrors, sibling files with no import edge). Use before editing a file to find what else usually changes with it, or to widen a change's blast radius beyond st…

Get the commit history for a specific file. Returns commits that touched the file, sorted by date (newest first). Faster than git log for indexed repositories.

Show git context for the working tree: uncommitted changes annotated with index status, recent commits, and changed files. Use this at the start of a session to understand what has already been modified before searching or editing.

Visualize how files relate to each other — imports, exports, and fan-in/fan-out. Faster than reading import statements across many files. Use 'focus' to zoom into a specific file's neighborhood. Use format 'json' for structured data with fan-in/fan-out metrics. Use search or read_relevant next to ex…

Find call sites and references to a symbol across indexed files — with file paths, line numbers, and matching lines. Resolves aliased imports: searching the original name finds call sites that import it under an alias (`import { getDB as g }; g()`). Primary matches come from an AST-derived reference…

List all files that a given file imports (its dependencies). Shows the resolved import graph — what this file actually depends on. This is FILE-level, outward direction. Routing — reverse (files that import this one) is dependents; for a single symbol's references use usages.

List all files that import a given file (reverse dependencies). Shows the blast radius before modifying a file — every file that would be affected by a change. This is FILE-level, inward direction. Routing — reverse (what this file imports) is depends_on; for finer SYMBOL-level blast radius use impa…

Symbol-level blast radius: the transitive callers of a function or method as a pruned call tree, plus the test files to run for the change. More precise than dependents (which is file-level). Use before changing a signature or behavior. Pass 'file' to disambiguate a name defined in several places. T…

Show how one symbol reaches another: the connecting call sub-graph from 'from' to 'to', with the shortest path highlighted. Answers 'how does X reach Y'. Reachability is COMPLETE — the whole reachable graph is searched (no hop limit), so a 'no path' result means truly unreachable, not 'too far'. Bra…

List the functions/methods a symbol directly calls (one hop out), each resolved to its definition file:line. The forward complement of usages (callers, one hop in) — use it to see what a function depends on before editing it. Static resolution: dynamic dispatch (callbacks, interface→impl, DI) and ca…

Given changed files (or the working-tree diff against HEAD by default), report the test files that transitively import them — what to run for this change. The interactive counterpart of the `affected` CLI; pair with impact for symbol-level blast radius. Returns changed (indexed) files, the tests to …

Index files in a directory for semantic search. Without patterns, indexes the project from config and prunes deleted or now-excluded files. With patterns, refreshes or expands only matching files and leaves the rest of the index untouched.

Show the current state of the RAG index for a project directory.

Remove a specific file from the RAG index.

Search the full codebase by meaning — finds files that grep misses. Use natural language ('how does auth work') or symbol names. Searches all indexed files semantically + by keyword in <100ms. Returns ranked file paths with snippets. Use read_relevant next to get full content with line ranges. Pass …

Get the actual content of the most relevant code chunks — individual functions, classes, or sections — with exact line ranges for navigation. Smarter than grep: finds code by meaning, not just string matching. Multiple chunks from the same file can appear. Use this instead of search + Read when you …

Find where a function, class, type, or interface is defined — by name, not semantics. Faster than grep for symbol lookup: searches the pre-built symbol index across all indexed files. Omit symbol to list all exports (filtered by type). Returns enrichment data: hasChildren, childCount, referenceCount…

Find the best file and location to insert new code or docs. Returns semantically appropriate insertion points with anchors for precise placement. Use this before adding a new function to find which file and position it belongs in.

Run the wiki rebuild workflow. The `command` argument uses colon selectors, for example `shape`, `prefetch:map:src/server.ts`, `discovery:page:tools/search`, or `write:page:tools/search`.