Perplexity ships `pplx`, a CLI for search that treats context windows like cash

Perplexity just dropped an official CLI, and it’s not trying to be your chat buddy. The tool, called pplx, is a stripped-down interface to the company’s Search API that spits out grounded results and extracted page text as JSON. No conversational mode. No model selection. No synthesized answers. Just two commands: pplx search web and pplx content fetch. It’s a utility built for piping data into other processes, and the contract is refreshingly strict — exit code 0 means exactly one JSON object on stdout. Anything else exits 1 with a JSON error object on stderr. As the docs put it, this targets “humans and coding agents equally.”

The design choices reveal who Perplexity really had in mind. The install path is a single shell pipe to sh that downloads a manifest, pins every artifact to a specific release tag to avoid racing a concurrent publish, verifies checksums, and drops the binary in ~/.local/bin/pplx. A receipt file is written only after the binary actually runs successfully. Platform support is limited to macOS on Apple Silicon, Linux x86_64, and Linux arm64. No Windows. No Intel Macs. That’s a deliberate set of constraints for CI pipelines and headless agents.

Context-window economics are baked into the tool as a first-class concern. The --stdout-preview flag truncates long string fields in stdout so you don’t blow up your agent’s context with multi-kilobyte snippets. But there’s a catch: it only works when paired with --output-dir or the $PPLX_OUTPUT_DIR environment variable. Use it alone and you get the full payload. Results land in {dir}/web/{rand}.json or {dir}/fetch/{rand}.json, written only after a successful request. For content fetches, the skill doc adds a blunt warning: check error and is_paywall before trusting the output.

The pricing puts teeth behind the token budgeting. Search API requests cost $5 per 1,000, capped at 50 QPS across all tiers. Agents that fire off queries without controlling output size will burn through credits fast. Auth for non-TTY environments — which means CI and agents — requires exporting PERPLEXITY_API_KEY since pplx auth login is interactive-only. The whole package feels less like a product launch and more like Perplexity handing agent builders a sharp tool and saying, “You know what you’re doing. Don’t waste our tokens.”