<div align="center">

pplx

Perplexity in your terminal.

Ask questions, get sourced answers with citations—streamed to your shell.

<br /> <img src="demo.jpeg" alt="pplx demo" width="720" /> <br /> </div>

---

Overview

This monorepo ships two packages:

| Package | Description | | :-------------------------- | :------------------------------------------------------------------------------ | | @pplx/cli | Terminal client with streaming output, interactive threads, and model switching | | @pplx/api | Streaming-first Perplexity API client for Node and Bun |

<br />

Getting Started

Installation

bun install
bun run install:dev  # links `pplx` globally

Authentication

Extract session cookies from the Perplexity desktop app:

pplx --login

Or set them manually:

export PPLX_COOKIES="<your session cookies>"

<br />

CLI

Quick queries

pplx "what caused the 2003 northeast blackout"

Focus modes

pplx -f academic "CRISPR delivery mechanisms 2024"
pplx -f youtube "best mass gainer review"
pplx -f reddit "mass gainer with creatine reviews"

Interactive chat

pplx chat

Chat supports slash commands to control the session:

| Command | Description | | :-------------- | :--------------------------------------------------------- | | /model <id> | Switch models (claude45sonnet, gpt5, o3, etc.) | | /focus <type> | internet · academic · youtube · reddit · writing | | /mode <mode> | copilot · concise | | /recency <r> | day · week · month · year · off | | /new | Start a fresh thread | | /exit | Quit |

<br />

Development

bun run check    # biome lint + typecheck
bun run fmt      # format
bun run cli      # run CLI in dev mode

<br />

License

MIT