Executes Exa AI search queries via Python CLI...
Dictum: Semantic search surfaces relevant content.
Execute Exa AI search queries via Python CLI. API key auto-injected via 1Password.
[IMPORTANT] Exa 2.0 introduced three search tiers: fast (sub-350ms), auto (balanced), deep (agentic, highest quality). Default: auto.
| [CMD] | [ARGS] | [RETURNS] |
|---|---|---|
| search | <query> [type] [num] |
Web results with text content |
| code | <query> [num] |
GitHub code context |
| find-similar | <url> [num] |
Pages similar to given URL |
| answer | <query> |
AI-generated answer with sources |
# Web search (default: auto type, 8 results)
uv run .claude/skills/exa-tools/scripts/exa.py search "Vite 7 new features"
# Neural search for concepts
uv run .claude/skills/exa-tools/scripts/exa.py search "Effect-TS best practices" neural
# Fast search for quick lookups
uv run .claude/skills/exa-tools/scripts/exa.py search "React 19 release notes" fast 15
# Deep search for highest quality
uv run .claude/skills/exa-tools/scripts/exa.py search "Nx workspace optimization" deep
# Code context search (GitHub)
uv run .claude/skills/exa-tools/scripts/exa.py code "React useState hook examples"
# Code search with custom results
uv run .claude/skills/exa-tools/scripts/exa.py code "Effect pipe examples" 20
# Find similar pages
uv run .claude/skills/exa-tools/scripts/exa.py find-similar "https://effect.website/docs/guides/essentials/pipeline"
# AI answer with citations
uv run .claude/skills/exa-tools/scripts/exa.py answer "What are the breaking changes in Vite 7?"
search: <query> [type] [num]
query โ Search query (required)type โ Search type: auto, neural, keyword, fast, deep (default: auto)num โ Number of results (default: 8)code: <query> [num]
query โ Code search query (required)num โ Number of results (default: 10)find-similar: <url> [num]
url โ Source URL to find similar pages for (required)num โ Number of results (default: 10)answer: <query>
query โ Question to answer with web sources (required)Commands return: {"status": "success|error", ...}.
| [INDEX] | [CMD] | [RESPONSE] |
|---|---|---|
| [1] | search |
{query, results[]} |
| [2] | code |
{query, context[]} |
| [3] | find-similar |
{url, results[]} |
| [4] | answer |
{query, answer, sources[]} |
| [VAR] | [REQUIRED] | [DESCRIPTION] |
|---|---|---|
EXA_API_KEY |
Yes | Exa API key (1Password injected) |
[ERROR] <status>: <body> and exit 1Retry-After header value[ERROR] 401: Unauthorized{"status": "success", "results": []} (not an error)