Evidence-first unified search

Use index.js when a task needs web retrieval plus a bounded search of local memory/ and skills/ content. Results are JSON on stdout; warnings are JSON on stderr so callers can preserve provenance.

Quick start

node index.js --query "latest climate policy" --sources '["tavily"]' --max_results 5
node index.js --query "meeting notes" --sources '["local"]' --max_results 10
node index.js --query "AI developments" --sources '["tavily","local"]' --max_results 10

Trust and scope

• tavily requires TAVILY_API_KEY and sends the query to Tavily.
• local searches only workspace memory/ and skills/, with bounded depth and file size.
• Symlinked files and directories are skipped; binary/unreadable files are ignored.
• web-search-plus and browser are accepted for compatibility but report that they are not configured rather than pretending to search them.
• Queries are trimmed and capped at 500 characters; max_results is 1–50.

Each result includes a source label, title, URL when available, score, and content/snippet. Treat network results as external evidence and verify important claims before relying on them.