{"slug": "perplexity-releases-pplx-a-single-binary-cli-that-puts-its-search-api-in-the-for", "title": "Perplexity Releases pplx, a Single-Binary CLI That Puts Its Search API in the Terminal for Coding Agents", "summary": "Perplexity released pplx, an official single-binary command line client for its Search API that returns grounded search results and extracted page text as JSON, targeting both humans and coding agents. The tool exposes two commands — pplx search web and pplx content fetch — with a strict output contract: exit code 0 and one JSON object on stdout for success, or exit code 1 with a JSON error on stderr for failure. Perplexity charges $5.00 per 1,000 requests with a 50 QPS cap across all usage tiers.", "body_md": "[Perplexity](https://www.perplexity.ai/) has released `pplx`\n\n, an official command line client for its Search API. The tool returns grounded search results and extracted page text, all as JSON. According to its docs, it targets humans and coding agents equally. It is not a chat client. There is no conversational mode, no model selection and no synthesized answer.\n\n**Two surfaces, one output contract**\n\nThe tool exposes exactly two working surfaces. `pplx search web`\n\nruns a live web search. `pplx content fetch`\n\npulls a URL and returns cleaned page text.\n\nThe contract around them is the interesting part. Per the official [ pplx-cli Agent Skill](https://github.com/perplexityai/api-platform-developers/blob/main/skills/pplx-cli/SKILL.md), success means exit code 0 and exactly one JSON object on stdout. Search returns\n\n`{hits: [{url, title, domain, snippet, ...}], total, saved_to?}`\n\n.Every failure exits 1 with an empty stdout. One JSON error object goes to stderr, shaped `{\"error\":{\"code\",\"message\",\"command\",\"hint\"?}}`\n\n. Documented codes include `AUTHENTICATION`\n\n, `UNKNOWN_ARGUMENT`\n\n, `ARGUMENT_ERROR`\n\nand `BAD_REQUEST`\n\n. The skill notes that list is not exhaustive, so callers should branch on `error.code`\n\n.\n\n**Install path and platform support**\n\nInstallation is a single shell command that pipes a script into `sh`\n\n:\n\n```\ncurl -fsSL https://github.com/perplexityai/perplexity-cli/releases/latest/download/install.sh | sh\n```\n\nReading [ install.sh](https://github.com/perplexityai/perplexity-cli/blob/main/install.sh) shows what it actually does. It downloads\n\n`manifest.json`\n\nfrom the latest release and extracts the tag and version. It then pins every remaining download to that tag, explicitly to avoid racing a concurrent publish.It fetches `SHA256SUMS`\n\nand the platform binary, verifies the checksum, and installs to `~/.local/bin/pplx`\n\n. No sudo is required. A receipt is written to `~/.config/pplx/pplx-receipt.json`\n\n, but only after the installed binary runs successfully.\n\nPlatform coverage is limited to three targets: macOS on Apple Silicon, Linux x86_64 and Linux arm64. Anything else exits with an error. There is no Windows build and no Intel macOS build.\n\n**Context-window economics are a first-class design concern**\n\nThe most agent-specific feature is token budgeting. `--output-dir`\n\nwrites the full result set to a JSON file. `--stdout-preview[=<CHARS>]`\n\ntruncates long string fields in stdout, adding `...<truncated>`\n\nmarkers.\n\nThe skill is blunt about the trap: `--stdout-preview`\n\nis a no-op without a save directory. It truncates only when the result is also saved via `--output-dir`\n\nor `$PPLX_OUTPUT_DIR`\n\n. Used alone it returns full-size output, and hits can be multiple KB each.\n\nSaved search results land at `{dir}/web/{rand}.json`\n\nand fetches at `{dir}/fetch/{rand}.json`\n\n. Files are written only after a successful request. `PPLX_OUTPUT_DIR`\n\nsets a workspace default so the flag need not be repeated.\n\nFor content fetch, the skill adds a correctness check rather than a cost one. Verify `error`\n\nand `is_paywall`\n\nin the output before trusting `content`\n\n. `--html`\n\nadds a `raw_html`\n\nfield fetched live via crawler, and `--no-cache`\n\nforces a live fetch.\n\n**Key Takeaways**\n\n`pplx`\n\nis a single verified binary exposing two commands:`pplx search web`\n\nand`pplx content fetch`\n\n.- Success is exit 0 plus one JSON object on stdout; failures put one JSON error object on stderr.\n`pplx auth login`\n\nis TTY-only, so agents and CI must export`PERPLEXITY_API_KEY`\n\n.`--stdout-preview`\n\nonly truncates when paired with`--output-dir`\n\nor`$PPLX_OUTPUT_DIR`\n\n.- Search API billing is $5.00 per 1,000 requests, capped at 50 QPS on every usage tier.\n\n**Sources:** [perplexityai/perplexity-cli](https://github.com/perplexityai/perplexity-cli), [pplx-cli SKILL.md](https://github.com/perplexityai/api-platform-developers/blob/main/skills/pplx-cli/SKILL.md), [api-platform-developers](https://github.com/perplexityai/api-platform-developers), [Perplexity API pricing](https://docs.perplexity.ai/docs/getting-started/pricing), [Rate limits and usage tiers](https://docs.perplexity.ai/docs/admin/rate-limits-usage-tiers), and [Search API quickstart](https://docs.perplexity.ai/docs/search/quickstart)\n\nMichal Sutter is a data science professional with a Master of Science in Data Science from the University of Padova. With a solid foundation in statistical analysis, machine learning, and data engineering, Michal excels at transforming complex datasets into actionable insights.", "url": "https://wpnews.pro/news/perplexity-releases-pplx-a-single-binary-cli-that-puts-its-search-api-in-the-for", "canonical_source": "https://www.marktechpost.com/2026/07/27/perplexity-releases-pplx/", "published_at": "2026-07-27 16:32:47+00:00", "updated_at": "2026-07-27 16:37:35.221493+00:00", "lang": "en", "topics": ["developer-tools", "ai-tools", "artificial-intelligence"], "entities": ["Perplexity", "pplx", "pplx search web", "pplx content fetch", "Perplexity Search API", "pplx-cli Agent Skill"], "alternates": {"html": "https://wpnews.pro/news/perplexity-releases-pplx-a-single-binary-cli-that-puts-its-search-api-in-the-for", "markdown": "https://wpnews.pro/news/perplexity-releases-pplx-a-single-binary-cli-that-puts-its-search-api-in-the-for.md", "text": "https://wpnews.pro/news/perplexity-releases-pplx-a-single-binary-cli-that-puts-its-search-api-in-the-for.txt", "jsonld": "https://wpnews.pro/news/perplexity-releases-pplx-a-single-binary-cli-that-puts-its-search-api-in-the-for.jsonld"}}