v2.4.2

What's Changed

Consolidated improvements from automation-opened fix branches:

Bug Fixes

• fix: correct glob patterns in .gitignore - Fixed broken _.log → *.log patterns

Dependencies

• chore(deps): update zod 4.3.6, @types/bun 1.3.8 - Latest stable versions

Documentation

• docs: clarify API key env var options - README now mentions PERPLEXITY_AI_API_KEY alternative

Improvements

• fix: add node: protocol to builtin imports - Best practice for cross-runtime (Bun/Node/Deno) compatibility

Install

bun install -g pplx-zero    # recommended
npm install -g pplx-zero    # requires bun
yay -S pplx-zero            # arch linux

v2.4.1 - RAG Continue Fix

Fixes critical bug: using -l and -c together now correctly preserves RAG context.

Bug: RAG context was lost when combining local search with conversation continue.
Fix: Build history context from original query, then prepend RAG context.

Found by @greptileai review. 42 tests passing.

v2.4.0 - True RAG

🧠 True RAG (Retrieval-Augmented Generation)

The -l flag now implements true RAG - your local documents become AI context.

How It Works

# 1. Build your knowledge base
pplx --ingest notes.md
pplx --ingest ./research/

# 2. Ask questions with local context
pplx -l "explain my notes on rust"
# [local] Found 2 relevant doc(s), using as context...
# [sonar] Based on your notes, Rust is...

What Changed

Before: -l just searched and printed results, then exited
After: -l searches → injects top matches as context → sends to Perplexity → streams AI answer

Technical Details

• SQLite FTS5 with BM25 ranking finds most relevant docs
• Top 3 matches injected as context (4000 char limit)
• UTF-8 safe truncation (won't break emojis)
• Cost-efficient: only sends relevant content, not entire knowledge base

New Tests

• 41 tests (up from 37)
• Coverage for RAG truncation, Unicode handling, OR queries

---

Full Changelog: v2.3.1...v2.4.0

v2.3.1 - Search Fix

🔍 Search Fix

Fixed multi-word search queries not finding results.

Bug

pplx -l "my learning" returned nothing because FTS5 required ALL words to match.

Fix

Search now uses OR with prefix matching:

• "my learning" → my* OR learning*
• Matches documents containing either word

---

Full Changelog: v2.3.0...v2.3.1

v2.3.0 - Local RAG

🧠 Local RAG

Build your own knowledge base and search it offline. Zero new dependencies.

✨ Features

• Index files: pplx --ingest notes.md
• Index directories: pplx --ingest ./docs/
• Glob patterns: pplx --ingest "*.md"
• Search locally: pplx -l "my notes on rust"
• SQLite FTS5: Fast full-text search with BM25 ranking
• Persistence: Files copied to ~/.pplx/knowledge/

📖 Usage

# Build your knowledge base
pplx --ingest notes.md
pplx --ingest ./research/
pplx --ingest "*.md"

# Search it
pplx -l "typescript patterns"

# Or still use Perplexity API
pplx "what is bun"

🔧 Technical

• SQLite FTS5 with porter stemming
• BM25 ranking for relevance
• Collision handling (notes.md → notes_1.md)
• Supports .md and .txt files

📊 Stats

• 37 tests passing
• ~900 lines of code
• Still just 1 dependency (zod)

---

Full Changelog: v2.2.2...v2.3.0

v2.2.0

What's New

• Pretty markdown by default - Rendered output with colors and formatting
• New --raw flag - Disable formatting when needed
• Streaming-compatible renderer (~60 LOC, zero deps)
• Bold, italic, headers, code blocks, lists, blockquotes

v2.1.0 - History & Sessions

What's New

History

• pplx --history - View past queries
• pplx --no-history - Skip saving sensitive queries
• Auto-rotates at 1000 entries
• Stored at ~/.pplx/history.jsonl

Session Continuation

• pplx -c "follow up question" - Continue from last query
• Context from previous Q&A is included automatically

File Output

• pplx -o research.md "topic" - Save to markdown
• pplx -o notes.txt "topic" - Save to plain text
• Great for deep research mode

Other

• 22 tests (8 new for history)
• Updated README with new features
• Blueprints for history and streaming architecture

Installation

bun install -g pplx-zero@2.1.0
# or
npm install -g pplx-zero@2.1.0

v2.0.0 - Complete Rewrite

pplx-zero v2.0.0

Complete rewrite from scratch. Stripped 8,347 LOC down to ~300 LOC.

What's New

• Minimal: Core search only, no bloat
• Fast: Bun-native, streaming responses
• 5 Models: sonar, sonar-pro, sonar-reasoning, sonar-reasoning-pro, sonar-deep-research
• File/Image support: -f for documents, -i for images
• Beautiful output: Colored terminal output with citations

Breaking Changes

• Requires Bun runtime
• Removed: monitoring, webhooks, history, exports, auto-updates
• Simplified CLI flags

Installation

# With bun (recommended)
bun install -g pplx-zero

# With npm (requires bun installed)
npm install -g pplx-zero

Usage

pplx "what is bun"
pplx -m sonar-pro "explain quantum computing"
pplx -f report.pdf "summarize this"
pplx -i screenshot.png "what's in this image"