basemind-documents

# basemind-documents — document RAG and web ingestion basemind extracts 90+ file formats (PDF, Office, HTML, email, images via OCR) into a LanceDB vector store and answers meaning-based queries with cross-encoder reranking. Web pages scraped or crawled into the same store are searchable the same way. This is the surface for "find the passage about X", not "grep for the string X". **basemind first, open-the-file fallback.** Prefer `search_documents` over opening PDFs/Office/HTML by hand, and the web tools over ad-hoc fetching. For source code use `basemind-code-search` instead — this skill is for prose and documents. ## Requirements - `search_documents` and the `memory_*` tools need a build with `--features documents` (or `full`). Without them the tools dispatch but return an MCP error. - Web ingestion (`web_scrape` / `web_crawl` / `web_map`) needs `--features crawl`. When that feature is **off** these tools are not registered at all — they simply won't appear in the tool list. - Documents must be scanned first: `basemind scan` with the documents feature extracts and embeds them into the machine-global cache (Linux `~/.local/share/basemind/`, macOS `~/Library/Application Support/basemind/`; override `BASEMIND_DATA_HOME`). See the `basemind-scan` skill. ## Tool routing | Question | MCP tool | CLI | |---|---|---| | "Semantic search over PDFs/Office/HTML docs?" | `search_documents` | `basemind memory search-documents "query"` | | "Narrow to docs mentioning an entity...