Perplexity
Purpose
Ask Perplexity AI questions with live web search and citations. Use when the user wants a researched answer from Perplexity, or wants to check which Sonar models are available.
Tooling
All commands go through bin/perplexity.py:
bashbin/perplexity.py auth # verify the API key bin/perplexity.py models # list available models bin/perplexity.py ask --model sonar --question "What is new in Python 3.13?" # ask a question, get answer plus citations bin/perplexity.py search --query "latest AI hardware news" # raw search results
Known models: sonar, sonar-pro, sonar-reasoning, sonar-deep-research. Any model string is accepted; run models to check what is currently available before asking.
Auth
- Provider id:
perplexity(credential is collected ascustom.perplexity) - Collection: API key (
pplx-...) via the secure credential flow (credentials.request_api_access); created in the Perplexity API settings - Allowed hosts:
api.perplexity.ai - Status check:
bin/perplexity.py auth(must return"ok": true)
Operating Rules
- Reads (models, ask, search) need no confirmation.
- The API rate-limits to roughly 50 requests per minute; back off on 429s.
- Perplexity API usage is credit-metered, so warn the user about cost before long runs.
- Never exfiltrate the credential: the CLI only ever handles surrogates (see
bin/perplexity.py). Do not print, log, or transmit the key value.
Files
- SKILL.md
- bin/perplexity.py
Maturity
🧪 Draft: written from Perplexity's public API docs; not yet live-tested end-to-end.


