Perplexity hat pplx veröffentlicht, einen offiziellen Kommandozeilen-Client für seine Search API, der fundierte Websuchergebnisse und extrahierten Seitentext als JSON ins Terminal bringt. Laut Projektdokumentation ist das Tool sowohl für menschliche Nutzer als auch für Coding Agents konzipiert.

Der Client ist keine Chat-Oberfläche. Er bietet keinen Konversationsmodus, keine Modellauswahl und keine synthetisierten Antworten. Stattdessen stellt er Funktionen der Search API über einen eingegrenzten Kommandozeilen-Workflow mit einem vorhersehbaren Ausgabeformat bereit. Diese Unterscheidung ist für Automatisierung wichtig: Skripte und Agents können Such- und Abrufresultate als strukturierte Daten verarbeiten, ohne auf eine Browser-Sitzung angewiesen zu sein oder eine natürlichsprachliche Chat-Antwort parsen zu müssen.

Zwei Befehle und ein strikter JSON-Vertrag

pplx stellt genau zwei funktionale Befehlsoberflächen bereit. pplx search web führt eine Live-Websuche aus, während pplx content fetch eine URL abruft und bereinigten Seitentext zurückgibt.

Der offizielle pplx-cli Agent Skill definiert den Ausgabe-Vertrag rund um diese Befehle. Eine erfolgreiche Anfrage endet mit Code 0 und schreibt genau ein JSON-Objekt nach stdout. Bei der Suche hat die Antwort die Form {hits: [{url, title, domain, snippet, ...}], total, saved_to?}.

Fehler werden separat behandelt. Jeder Fehler endet mit Code 1, lässt stdout leer und schreibt ein JSON-Fehlerobjekt nach stderr in der Form {"error":{"code","message","command","hint"?}}. Zu den dokumentierten Fehlercodes gehören AUTHENTICATION, UNKNOWN_ARGUMENT, ARGUMENT_ERROR und BAD_REQUEST. Der Agent Skill weist darauf hin, dass die Liste nicht vollständig ist; Aufrufer sollten daher anhand von error.code verzweigen, statt anzunehmen, dass nur diese Codes auftreten. Die Trennung zwischen stdout und stderr folgt außerdem einem gängigen Unix-Muster, was es aufrufenden Prozessen erleichtert, erfolgreiche Daten von operativen Fehlern zu trennen.

Installation und unterstützte Plattformen

Die Installation erfolgt über einen einzelnen Shell-Befehl, der ein Installationsskript an sh weiterleitet. Das Skript install.sh lädt manifest.json aus dem neuesten Release herunter und extrahiert Tag und Version. Anschließend werden alle verbleibenden Downloads auf diesen Tag festgelegt, ausdrücklich um Überschneidungen mit einer gleichzeitig laufenden Veröffentlichung zu vermeiden.

Das Skript lädt SHA256SUMS und das passende Plattform-Binary herunter, verifiziert die Prüfsumme und installiert die Binärdatei nach ~/.local/bin/pplx. sudo ist nicht erforderlich. Ein Beleg wird in ~/.config/pplx/pplx-receipt.json geschrieben, allerdings erst nachdem die installierte Binärdatei erfolgreich ausgeführt wurde.

Die Plattformunterstützung ist auf drei Ziele beschränkt: macOS auf Apple Silicon, Linux x86_64 und Linux arm64. Nicht unterstützte Plattformen beenden den Vorgang mit einem Fehler. Es gibt keinen Windows-Build und keinen Build für Intel macOS.

Token-Budgetierung für Agent-Workflows

Eine der am stärksten auf Agents ausgerichteten Funktionen ist die Token-Budgetierung. Die Option --output-dir schreibt den vollständigen Ergebnissatz in eine JSON-Datei, während --stdout-preview[=<CHARS>] lange Zeichenkettenfelder in stdout kürzt und Markierungen wie ...<truncated> hinzufügt.

Der Agent Skill hebt eine wichtige Einschränkung hervor: --stdout-preview hat keine Wirkung, sofern nicht auch ein Speicherverzeichnis konfiguriert ist. stdout wird nur gekürzt, wenn das vollständige Ergebnis über --output-dir oder $PPLX_OUTPUT_DIR gespeichert wird. Allein verwendet gibt die Option die Ausgabe in voller Größe zurück, und einzelne Treffer können jeweils mehrere Kilobyte umfassen.

Gespeicherte Suchergebnisse werden nach {dir}/web/{rand}.json geschrieben, Abrufresultate nach {dir}/fetch/{rand}.json. Dateien werden nur nach einer erfolgreichen Anfrage geschrieben. Die Umgebungsvariable PPLX_OUTPUT_DIR kann einen Workspace-Standard setzen, sodass das Verzeichnis-Flag nicht wiederholt werden muss. Dieses Design ermöglicht automatisierten Workflows, vollständige Artefakte auf der Festplatte zu behalten und zugleich eine kleinere Vorschau durch das Kontextfenster oder den Log-Stream zu leiten.

Für den Inhaltsabruf ergänzt die Dokumentation eher eine Korrektheitsprüfung als eine Kostenkontrolle: Nutzer sollten error und is_paywall in der Ausgabe überprüfen, bevor sie abgerufenen Inhalten vertrauen. Die Option --html fügt ein Feld raw_html hinzu, das live über den Crawler abgerufen wird, und --no-cache erzwingt einen Live-Abruf.

Auch die Authentifizierung ist für automatisierte Nutzung relevant. pplx auth login funktioniert nur mit TTY, daher müssen Agents und CI-Umgebungen PERPLEXITY_API_KEY exportieren. Die Abrechnung der Search API ist mit $5.00 pro 1.000 Anfragen angegeben, mit einem Limit von 50 QPS auf jeder Nutzungsstufe.

Zu den im Originalbericht genannten Quellen gehören perplexityai/perplexity-cli, pplx-cli SKILL.md, api-platform-developers, Perplexity API pricing, Rate limits and usage tiers und der Search API quickstart.