name: perplexity-tools type: complex depth: base user-invocable: false 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", ...}.