Semantic (meaning-based) search across all indexed files.

Use for conceptual questions where the exact wording is unknown, e.g. "my notes on value functions" or "that paper about cousin marriage". For an exact term, function name, or literal phrase, use search_keyword instead. Returns ranked chunks with file path, file_id, and cosine distance (lower = closer). Requires the ollama server to be running.

Exact keyword / phrase search over extracted file text (FTS5, BM25-ranked).

Use when looking for a specific term, function name, or literal phrase rather than a conceptual match — semantic search is weak at exact matches. Supports FTS5 syntax: AND / OR / NOT, "quoted phrases", and prefix* wildcards. For meaning-based questions use search instead. Returns files with a matching snippet and file_id, best matches first.

Read an indexed file's text by file_id (from a search result).

Two modes:

• around_chunk < 0 (default): the whole extracted text. Large files are capped — prefer a window (below) to read a specific part of a big doc.

• around_chunk >= 0: that chunk plus radius chunks on each side, in order. This is how you expand around a specific search hit: pass the file_id and the chunk index the search returned to get its surrounding context.

Browse indexed files by metadata (not a content search).

Filter by extension (e.g. "pdf", no leading dot) and/or name_contains (a substring matched anywhere in the full path — a filename or a folder). Use for exploration like "my PDFs under Documents" or "notebooks named train". Returns file_id, size, and path, largest first.