Documentation Index
Fetch the complete documentation index at: https://docs.praison.ai/llms.txt
Use this file to discover all available pages before exploring further.
Perplexity Search CLI
Use Perplexity real-time web search from the command line.
Prerequisites
# Install the package
npm install @perplexity-ai/ai-sdk
# Set your API key
export PERPLEXITY_API_KEY=your-perplexity-api-key
Commands
praisonai-ts tools list --tag search
praisonai-ts tools info perplexity
Health Check
praisonai-ts tools doctor
# Dry run
praisonai-ts tools test perplexity
# Live test
praisonai-ts tools test perplexity --live
Search Examples
Basic Search
praisonai-ts agent run \
--tools perplexity \
--prompt "What are the latest AI developments?"
Recent News
praisonai-ts agent run \
--tools "perplexity:recency=day" \
--prompt "What happened in tech today?"
Domain-Filtered Search
praisonai-ts agent run \
--tools "perplexity:searchDomainFilter=arxiv.org" \
--prompt "Find recent papers on transformer architectures"
Language-Specific Search
praisonai-ts agent run \
--tools "perplexity:language=en" \
--prompt "Search for AI news in English"
| Option | Type | Default | Description |
|---|
recency | string | - | day, week, month, year |
language | string | - | ISO 639-1 language code |
searchDomainFilter | string[] | - | Domains to search |
numResults | number | 10 | Number of results |
Advanced Examples
News Analysis
praisonai-ts agent run \
--instructions "You are a news analyst" \
--tools "perplexity:recency=day,numResults=5" \
--prompt "Analyze today's top tech stories"
Academic Research
praisonai-ts agent run \
--instructions "You are a research assistant" \
--tools "perplexity:searchDomainFilter=arxiv.org|nature.com" \
--prompt "Find recent research on quantum computing"
JSON Output
praisonai-ts agent run \
--tools perplexity \
--prompt "AI news" \
--json
praisonai-ts agent run \
--tools "perplexity,exa" \
--prompt "Compare search results about GPT-5 from multiple sources"
Environment Variables
| Variable | Required | Description |
|---|
PERPLEXITY_API_KEY | Yes | Perplexity API key |
OPENAI_API_KEY | Yes | OpenAI API key |
praisonai-ts tools list - List all tools
praisonai-ts tools doctor - Check tool health