docs-search

name	docs-search
description	Agentic search over the DSRs docs via Mixedbread toast-1. Use when answering questions about DSRs concepts, components, or APIs (signatures, predict, modules, IR, holes, optimizers, .dsrs files) instead of grepping docs/ page by page.

DSRs docs search

The published docs are indexed in a Mixedbread Store (dsrs-docs) and the Rust sources in dsrs-code; both are queried with toast-1 agentic search, which decomposes the question into subqueries and returns curated chunks. ask can also grep the code store for exact symbols.

Run from the repository root (needs mixedbread installed and MXBAI_API_KEY in the environment or .env):

python3 docs/scripts/search_docs.py search "<question>" [--top-k N] [--json]
python3 docs/scripts/search_docs.py ask "<question>"

search returns raw chunks with source paths — prefer it when you plan to read the pages yourself. ask has toast-1 compose a grounded answer — prefer it for a quick factual check.

• Phrase the query as a full question, not keywords — toast-1 plans its own subqueries from it.
• Each result prints the source page path (e.g. docs/components/holes.mdx) and the chunk text; expect ~10s latency.
• Read the source page under docs/ when a chunk looks truncated.
• If results look stale relative to the working tree, the index only tracks pushed docs — trust the local files and optionally run python3 docs/scripts/search_docs.py sync to refresh.