Perplexity Releases pplx, a Single-Binary CLI That Deploys Its Search API to Terminal Coding Agents
Confusion is released pplxthe official command-line client for its Search API. The tool returns the base search results and the extracted page text, all as JSON. According to its documentation, it targets humans and coding agents equally. It is not a chat client. There is no chat mode, no model selection and no integrated feedback.
Two locations, one outbound contract
The tool directly exposes two working areas. pplx search web uses live web search. pplx content fetch pulls the URL and returns the text of the cleaned page.
The contract around them is the interesting part. According to the official pplx-cli Agent Skill, success means exit with 0 code and one JSON object in stdout. Search for returns {hits: [{url, title, domain, snippet, ...}], total, saved_to?}.
All failures output 1 with an empty stdout. One JSON error object goes to stderr, shape {"error":{"code","message","command","hint"?}}. Written codes include AUTHENTICATION, UNKNOWN_ARGUMENT, ARGUMENT_ERROR again BAD_REQUEST. The ability notes that the list is incomplete, so callers should continue error.code.
Enter the path and platform support
Install is a single shell command that installs text into it sh:
curl -fsSL | shReading install.sh shows what it actually does. It’s downloading manifest.json from the latest release and remove the tag and version. It then pins all remaining downloads to that tag, clearly to avoid a simultaneous publishing race.
It’s downloading SHA256SUMS and the binary field, verifying the checksum, and including the ~/.local/bin/pplx. No sudo is needed. A receipt was written ~/.config/pplx/pplx-receipt.jsonbut only after the installed binary has run successfully.
Platform coverage is limited to three targets: macOS on Apple Silicon, Linux x86_64 and Linux arm64. Anything else comes out by mistake. There is no Windows build and no Intel macOS build.
Context-window economics is a first-stage design concern
The most focused feature is the token budgeting agent. --output-dir writes the full result set to a JSON file. --stdout-preview[= truncates long string fields in stdout, added it ... symptoms.
A blunt skill about a trap: --stdout-preview it is a no-op without a save index. It only decreases if the result is also saved with --output-dir or $PPLX_OUTPUT_DIR. Used alone it returns full-sized output, and hot can be many KB each.
The saved search results come up {dir}/web/{rand}.json and downloads from {dir}/fetch/{rand}.json. Files are only written after a successful request. PPLX_OUTPUT_DIR sets the default for the workspace so the flag does not repeat.
In order to download content, the ability adds a fairness test rather than a cost. Confirm error again is_paywall in output before trust content. --html adds a raw_html the field is fetched live by the browser, too --no-cache forces a live download.
Key Takeaways
pplxone confirmed binary that displays two commands:pplx search webagainpplx content fetch.- Success outputs 0 and one JSON object to stdout; failure puts a single JSON error object on stderr.
pplx auth loginTTY-only, so agents and CI must exportPERPLEXITY_API_KEY.--stdout-previewit only reduces when paired with it--output-diror$PPLX_OUTPUT_DIR.- API search billing is $5.00 per 1,000 requests, capped at 50 QPS across the usage spectrum.
Sources: perplexityai/perplexity-cli, pplx-cli SKILL.md, api-platform-developers, Perplexity API pricing, Rate limits and usage categories, and Search API quickstart
Michal Sutter is a data science expert with a Master of Science in Data Science from the University of Padova. With a strong foundation in statistical analysis, machine learning, and data engineering, Michal excels at turning complex data sets into actionable insights.
