Search indexed documents using hybrid semantic + keyword search.

Combines vector similarity and BM25 full-text search via Reciprocal Rank Fusion (RRF) for better recall on both meaning and exact terms.

Args: query: Natural language search query. limit: Maximum number of results (default 10, max 50). document_filter: Optional exact document name to filter by. collection: Optional collection name to search within. page_type: Optional content type filter (text, code, spreadsheet, etc.). source_format: Optional source format filter (.pdf, .py, .xlsx, etc.). agent_handle: Optional agent handle to filter by (e.g. "rmh"). memory_type: Optional memory type filter (fact, observation, etc.).

Ingest an HTTP(S) URL into the knowledge base.

Fetches a URL with smart sitemap discovery and single-page fallback. For local files and directories, use register_directory + sync_all_registrations — the daemon owns the filesystem, so there is no in-process file loader here.

Returns immediately — the daemon indexes in the background.

Args: source: HTTP(S) URL to ingest. overwrite: If true, replace existing data. collection: Collection name. Auto-derived if empty.

Remember inline text content: chunk, embed, and index for search.

Use this instead of ingest when you have the text content directly (e.g., clipboard, API response, or sandbox-uploaded files in Claude Desktop). The daemon scrubs secrets/PII before indexing.

Returns immediately — the daemon indexes in the background.

Args: content: The text content to remember. document_name: Name for the document (e.g., 'notes.md'). overwrite: If true, replace existing data for this document. collection: Collection name (default: 'default'). format_hint: Format hint: 'auto', 'plain', 'markdown', 'latex'. agent_handle: Agent that owns this memory (e.g. "rmh"). memory_type: Memory classification: fact, observation, opinion, procedure. summary: One-line summary of the content.

List documents, collections, databases, or registrations.

Args: kind: What to list — "documents", "collections", "databases", or "registrations". collection: Optional collection filter (only for kind="documents").

Show document metadata or retrieve a specific page's text.

Without page_number: shows document metadata (pages, chunks, collection). With page_number: shows the full text for that page.

Args: document_name: Document filename (e.g., 'report.pdf'). page_number: Page number (1-indexed). 0 means show metadata only. collection: Optional collection scope.

Delete indexed data for a document or collection.

Returns immediately — the daemon removes chunks in the background.

Args: name: Document filename or collection name to delete. kind: What to delete — "document" or "collection". collection: Optional collection scope (only for kind="document").

Register a directory for incremental sync.

Returns immediately — the daemon records the registration in the background.

Args: directory: Absolute path to the directory. collection: Collection name. Uses directory name if empty.

Remove a directory registration.

Returns the removed-file count synchronously; the chunk purge runs as a background task. An unknown collection surfaces as an error, not a removal confirmation.

Args: collection: Collection name to deregister. keep_data: If true, keep indexed data in LanceDB.

Sync all registered directories: ingest new/changed, remove deleted.

Returns immediately — the daemon runs the sync in the background.

Get database status: document/chunk counts, storage size, and model info.

Switch to a different named database for subsequent operations.

All tools (find, ingest, sync, etc.) will target the selected database's daemon until changed again. Use list(kind="databases") to see the database the daemon is fixed to.

Only selects among LOCAL databases: while a remote target (QUARRY_URL or a 'quarry login') is active, the remote daemon is fixed to its own database and this has no effect.

Args: name: Database name (e.g., 'coding', 'work'). Use 'default' for the default database.