compound-perplexity 0.1.0

CLI for the Perplexity API — search, ask, research, and reason from your terminal.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

# compound-perplexity

CLI for the Perplexity API. Search, ask, research, and reason from your terminal.

## Install

```bash
cargo install compound-perplexity
```

The binary is called `pplx`.

## Commands

| Command | What it does | Model | Est. cost |
|---------|-------------|-------|-----------|
| `pplx search <query>` | Quick web search | sonar | ~$0.006 |
| `pplx ask <query>` | Pro search with analysis | sonar-pro | ~$0.01 |
| `pplx research <query>` | Deep research | sonar-deep-research | ~$0.40 |
| `pplx reason <query>` | Reasoning with thinking | sonar-reasoning-pro | ~$0.01 |
| `pplx log` | Show recent queries | — | — |
| `pplx log --stats` | Usage and cost breakdown | — | — |

## Features

- **Four modes** matching Perplexity's model tiers — from quick lookups to deep research
- **Cited sources** extracted and displayed inline
- **Cost tracking** — every query logged with timestamp, model, estimated cost, and duration
- **Color-coded output** — each mode has a distinct colour for easy scanning
- **`--raw`** flag for JSON output, **`--no-log`** to skip history

Requires `PERPLEXITY_API_KEY` in your environment.

## License

MIT