pplx

Perplexity’s Search API in your terminal. pplx gives you grounded web search results and query-relevant page snippets as JSON, built for both humans and coding agents.

Install

curl -fsSL https://github.com/perplexityai/perplexity-cli/releases/latest/download/install.sh | sh

The installer downloads the binary for your platform, verifies its SHA-256 checksum, and installs it to ~/.local/bin/pplx. No sudo. Set PPLX_INSTALL_PATH to install somewhere else.

Manual install

Download the binary for your platform and SHA256SUMS from the latest release, then verify and install:

grep pplx-aarch64-apple-darwin.bin SHA256SUMS | shasum -a 256 -c -
chmod +x pplx-aarch64-apple-darwin.bin
mv pplx-aarch64-apple-darwin.bin ~/.local/bin/pplx

On Linux, use sha256sum -c - instead of shasum -a 256 -c -.

Supported platforms

Authentication

Get an API key at perplexity.ai/account/api. Then either export it:

export PERPLEXITY_API_KEY=pplx-...

or store it once:

pplx auth login

PERPLEXITY_API_KEY takes precedence over the stored key when both are set.

Usage

Every command prints JSON to stdout, so results pipe cleanly into jq and drop straight into agent tool calls.

Web search

pplx search web "rust async runtimes"
pplx search web "rust programming" -n 5
pplx search web "query" "related query 1" "related query 2"
pplx search web "model releases" --domains wikipedia.org,arxiv.org
pplx search web "openai news" --recency-filter week
pplx search web "openai news" --published-after-date 3/1/2026 --published-before-date 3/5/2026

Output is { hits: [{ url, title, domain, snippet, ... }], total }. Common flags (see pplx search web --help for the full list):

Content snippets

Extracts the parts of pages that are relevant to a query, from up to 50 URLs in one call. Each extra URL adds another page to snippet, and elided regions inside a snippet are marked with …. Requires v0.2.3 or newer; pplx update upgrades in place.

pplx content snippets "rust async runtimes" https://tokio.rs https://docs.rs/smol --max-tokens 256 --max-tokens-per-page 128

{"results":[
  {"url":"https://tokio.rs","text":"Learn\nAPI Docs\nBlog\nBuild reliable network applications without compromising speed.\nTokio is an asynchronous runtime for the Rust programming language. …","tokens_count":82},
  {"url":"https://docs.rs/smol","text":"div\n\n# Crate smol\nSource\nExpand description\n\nA small and fast async runtime. …","tokens_count":126}
]}

--max-tokens caps total tokens across all snippets (1-16384, default: 4096); --max-tokens-per-page caps each page (1-4096, must be /snippets/`.

content fetch is deprecated and will stop working; use content snippets.

For coding agents

An Agent Skill teaches coding agents to install and use pplx for web search and page snippets. Point any agent at it directly:

Read https://raw.githubusercontent.com/perplexityai/api-platform-developers/main/skills/pplx-cli/SKILL.md, install the skill, and use it for search.

Or install it as a Claude Code plugin: /plugin marketplace add perplexityai/api-platform-developers, then /plugin install perplexity-platform@api-platform-developers.

Updating

pplx update

pplx update (v0.2.2+) downloads the latest release for your platform, verifies its SHA-256 checksum against the release manifest, and atomically replaces the installed binary. pplx update --check reports whether a newer release exists without installing anything. Neither needs an API key.

Re-running the install one-liner also works and replaces the binary in place.

Environment variables

Versioning

Releases in this repository are semver-tagged (vX.Y.Z). pplx --version prints a date-stamped build version in the form YYYY.MM.DD.+ (for example 2026.07.20.1784555998+174b21c) identifying the exact build. Each release’s manifest.json asset ties the two together by recording the build version alongside the release tag.

Uninstall

rm ~/.local/bin/pplx ~/.config/pplx/pplx-receipt.json

If present, also remove the stored API key in ~/.config/perplexity/credentials.json (Linux) or ~/Library/Application Support/perplexity/credentials.json (macOS).