| name | perplexity-tools |
| type | complex |
| depth | base |
| description | Executes Perplexity AI queries via unified Python CLI. Use when conducting web research, asking questions with citations, deep research tasks, reasoning problems, or searching for up-to-date information. |
[H1][PERPLEXITY-TOOLS]
Dictum: Specialized models optimize response quality.
Execute Perplexity AI queries via unified Python CLI.
[IMPORTANT] Commands require --query. API key auto-injected via 1Password.
# Quick question—citations (sonar)
uv run .claude/skills/perplexity-tools/scripts/perplexity.py ask --query "What is Effect-TS?"
# Deep research (sonar-deep-research)
uv run .claude/skills/perplexity-tools/scripts/perplexity.py research --query "React 19 new features"
uv run .claude/skills/perplexity-tools/scripts/perplexity.py research --query "Vite 7 migration" --strip-thinking
# Reasoning task (sonar-reasoning-pro)
uv run .claude/skills/perplexity-tools/scripts/perplexity.py reason --query "Compare Vite vs Webpack"
uv run .claude/skills/perplexity-tools/scripts/perplexity.py reason --query "Effect vs RxJS" --strip-thinking
# Web search (sonar)
uv run .claude/skills/perplexity-tools/scripts/perplexity.py search --query "Nx 22 Crystal" --max-results 5
[1][OUTPUT]
Commands return: {"status": "success|error", ...}.
| [INDEX] | [CMD] | [RESPONSE] |
|---|---|---|
| [1] | ask |
{query, response, citations[]} |
| [2] | research |
{query, response, citations[]} |
| [3] | reason |
{query, response} |
| [4] | search |
{query, results[]} |