Knowledge is enough. The terminal-native AI coding agent for everyone.

📖 Docs

• AI-Powered Coding — Leverage Perplexity's deep reasoning to write, refactor, and debug code with full context awareness
• Terminal Native — Runs entirely in your terminal with interactive and non-interactive modes
• Web Search — Built-in web search tool powered by the Perplexity Search API for up-to-date documentation and references
• Session Management — Conversations are automatically saved and can be continued or resumed
• Session Sharing — Share coding sessions via share.perplx.net with full markdown and syntax highlighting
• File & Image Input — Attach source files or images as context using @ prefixed paths
• Extensible — Support for custom extensions, skills, prompt templates, and themes

Requires Bun and pnpm.

git clone https://github.com/perplx-ai/perplx.git
cd perplx/tool
pnpm install
bun build src/cli.ts --target node --compile --outfile ~/.local/bin/perplx

Make sure ~/.local/bin is in your PATH.

For development:

cd perplx/tool
pnpm dev

On first launch, you'll be prompted to authenticate with a Perplexity API key:

$ perplx
# Go to https://console.perplexity.ai
# Navigate to the API Keys tab and generate a new key.
# Paste your Perplexity API key: pplx-xxxxxxxx...

Credentials are stored locally at ~/.perplx/agent/auth.json.

Launch perplx in any project directory to start a conversation:

$ perplx
> add error handling to the database module
> now write tests for it

Use Ctrl+P to cycle between models during a session.

For scripting and pipelines — process a prompt and exit:

perplx -p "explain this function" @src/utils.ts

Pipe stdin:

cat error.log | perplx "what went wrong?"

Attach files as context with @:

perplx @src/auth.ts @src/middleware.ts "refactor these to use a shared session"

perplx --continue    # continue the last session
perplx --resume      # browse and select a session to resume

Three model tiers served through the Perplexity Agent API:

Default model is smart.

All configuration lives under ~/.perplx/:

perplx/
├── tool/
│   └── src/
│       ├── cli/        # Argument parsing & file processing
│       ├── core/       # Agent session, tools, settings, extensions
│       ├── modes/      # Interactive & print modes
│       ├── providers/  # Perplexity provider & web search tool
│       └── utils/
├── worker/         # Session sharing backend (Cloudflare Worker + Hono + D1)
├── website/        # Landing page & docs (static, Cloudflare Pages)
└── drafts/         # Design drafts