Build a local, private index of a repository: files, symbols (functions/classes/types), import graph, and optional embeddings. Zero network calls — the index never leaves the machine.

Args:

• path (string): repository root, default "."

• max_files (number): safety cap, default 50000

• response_format ('markdown' | 'json'): default 'markdown'

Returns: File/chunk/symbol counts, embedder mode (onnx or lexical), duration.

Use when: the user asks to index/analyze the codebase, or before localscope_search / localscope_impact on a repo not indexed yet in this session.

Search the local index for code or docs by meaning, symbol name, or fragment. Combines embeddings (if installed) with lexical identifier matching — all offline.

Args:

• query (string): what to find, e.g. "retry with backoff", "parseConfig", "where do we validate webhooks"

• path (string): repo root previously indexed, default "."

• limit (number): max results 1-100, default 20

• response_format ('markdown' | 'json'): default 'markdown'

Returns: Hits with file, line range, symbol, score, snippet, and how it matched (semantic/lexical/symbol).

Use when: "where is X handled?", "find code that does Y". Requires localscope_index first.

Answer "where does X break if I change Y?" from the local import graph and symbol table — entirely offline.

Args:

• target (string): file path relative to repo root (e.g. 'src/utils/parse.ts') OR a symbol name (e.g. 'parseConfig')

• path (string): repo root previously indexed, default "."

• max_depth (number): reverse-dependency walk depth 1-10, default 5

• response_format ('markdown' | 'json'): default 'markdown'

Returns: Direct dependents (files importing the target), transitive dependents, and exported symbols at risk.

Use when: "what breaks if I refactor/delete this?", "who uses this function?". Requires localscope_index first.

Show whether a repository root has a local index, its stats (files/chunks/symbols), and the active embedder mode. Read-only, offline.

Args:

• path (string): repo root, default "."

• response_format ('markdown' | 'json'): default 'markdown'

Returns: Indexed state, counts, embedder mode, indexedAt timestamp.