Perplexity Releases pplx, a JSON-Only Search CLI Built for Coding Agents
The official command-line client offers exactly two commands, deterministic exit codes and token budgeting — and deliberately no chat mode at all.
In Brief
- Perplexity released pplx, an official command-line client for its Search API that returns grounded search results and extracted page text as pure JSON
- The tool is deliberately not a chat client — no conversational mode, no model selection, no synthesized answers — and targets coding agents as first-class users
- Search API billing runs $5.00 per 1,000 requests capped at 50 QPS, with builds for macOS Apple Silicon and Linux only
Perplexity has released pplx, an official command-line client for its Search API that returns grounded web search results and extracted page text as JSON, according to MarkTechPost. Per its documentation, the tool targets humans and coding agents equally — and it is pointedly not a chat client: there is no conversational mode, no model selection and no synthesized answer.
The client exposes exactly two working surfaces. “pplx search web” runs a live web search, returning hits with URL, title, domain and snippet fields; “pplx content fetch” pulls a URL and returns cleaned page text. The output contract is strict: success means exit code 0 and exactly one JSON object on stdout, while every failure exits 1 with a JSON error object on stderr carrying documented codes like AUTHENTICATION, UNKNOWN_ARGUMENT, ARGUMENT_ERROR and BAD_REQUEST.
That rigidity is the point. Deterministic exit codes and machine-parseable errors are what let autonomous coding agents branch on failures instead of hallucinating around them — a design language that treats scripts, not people, as the primary audience.
pplx makes context-window economics a first-class feature
The most agent-specific feature is token budgeting. A –output-dir flag writes full result sets to JSON files, while –stdout-preview truncates long string fields in terminal output with explicit truncation markers — keeping multi-kilobyte search hits from flooding an AI agent’s context window. MarkTechPost flags the documented trap: –stdout-preview is a no-op unless results are also being saved via –output-dir or the PPLX_OUTPUT_DIR environment variable; used alone, it returns full-size output.
Authentication follows the same agent-first logic. The interactive “pplx auth login” flow is TTY-only, so agents and CI pipelines must export a PERPLEXITY_API_KEY instead. For content fetching, the docs tell callers to verify error and is_paywall fields before trusting extracted text, with –html adding raw HTML and –no-cache forcing live fetches.
Installation is a single command that pipes a script into sh. The installer downloads a manifest from the latest GitHub release, pins every download to that release tag to avoid racing a concurrent publish, verifies SHA256 checksums, and installs to ~/.local/bin without sudo. Platform coverage is limited to macOS on Apple Silicon, Linux x86_64 and Linux arm64 — no Windows build, no Intel macOS.
The API-tooling race for agent developers
Pricing runs through Perplexity’s existing Search API: $5.00 per 1,000 requests, capped at 50 queries per second on every usage tier. That undercuts assembling equivalent grounded-search pipelines from scraping infrastructure, and positions pplx against a crowded field of search tools jockeying to become the default retrieval layer for AI agents.
The release fits a broader pattern of AI companies shipping developer primitives rather than just chat interfaces — the same week Perplexity continues fighting accusations over its crawling practices, it is selling clean, paid, structured access to the web as a product. Notably, the repository ships its own machine-readable skill file documenting the tool’s contract for AI agents — an acknowledgment that the tool’s most important users may never read a README.
For developers building agents, the calculus is simple: grounded search with deterministic JSON contracts, versus rolling your own retrieval. At $5 per thousand queries, Perplexity is betting a lot of agent builders would rather pay than parse.
FAQ
What is Perplexity’s pplx CLI?
An official command-line client for Perplexity’s Search API with two commands — web search and URL content fetch — that return structured JSON, designed for both humans and coding agents.
Is pplx a chatbot?
No. It has no conversational mode, no model selection and no synthesized answers; it returns raw grounded search results and cleaned page text only.
How much does using pplx cost?
The CLI is free; the underlying Search API bills $5.00 per 1,000 requests with a 50 queries-per-second cap on every usage tier.
