Perplexity가 공식 커맨드라인 클라이언트 pplx를 출시했습니다. 사람이 쓰는 대화형 AI 도구가 아닙니다. 코딩 에이전트가 웹을 검색하고 페이지를 읽도록 설계된 단일 바이너리 도구1입니다. 대화 모드도, 모델 선택 기능도, AI가 정리해주는 요약 답변도 없습니다. 오직 명령 하나에 JSON 하나만 반환할 뿐입니다2.
단 두 개의 명령어와 엄격한 규칙
pplx가 제공하는 기능은 정확히 두 가지입니다. pplx search web은 실시간 웹 검색을 실행하고, pplx content fetch는 URL에서 정제된 본문 텍스트를 가져옵니다1.
진짜 핵심은 이 명령어들을 감싼 출력 규칙입니다. 성공 시에는 exit code 0과 함께 stdout으로 단 하나의 JSON 객체를 반환합니다. 검색 명령은 {hits: [{url, title, domain, snippet, ...}], total}을, 실패 시에는 exit code 1과 함께 stderr로 오류 JSON을 보냅니다2. 이 규칙 덕분에 결과를 jq로 바로 파이핑하거나 에이전트 도구 호출에 직결할 수 있습니다.
인증도 단순합니다. pplx auth login으로 저장하거나 PERPLEXITY_API_KEY 환경 변수를 내보내면 됩니다. CI/CD 환경에서 에이전트가 쓸 때는 로그인 명령이 TTY를 요구하므로 반드시 환경 변수 방식을 써야 한다는 점만 기억하면 됩니다1.
에이전트를 위한 진짜 설계: 컨텍스트 윈도우 비용 통제
이 도구가 "코딩 에이전트용"으로 불리는 진짜 이유는 토큰 예산 관리 기능에 있습니다. 일반적으로 검색 결과의 전체 JSON을 그대로 컨텍스트 윈도우에 넣으면 금세 토큰을 낭비하게 됩니다.
pplx는 이 문제를 --stdout-preview와 --output-dir 플래그로 해결합니다. --output-dir로 결과를 파일로 저장하면서 --stdout-preview[=<CHARS>]를 함께 쓰면, stdout에는 긴 문자열 필드를 잘라낸 미리보기만 출력하고 원본은 파일에 보관합니다1. 반드시 두 플래그를 같이 써야 동작한다는 점이 주의할 부분이지만, 이는 에이전트가 컨텍스트를 낭비하지 않도록 강제하는 의도된 설계입니다. 저장된 결과는 {dir}/web/{rand}.json 또는 {dir}/fetch/{rand}.json 경로에 남습니다.
설치 방식도 이 철학을 그대로 반영합니다. curl로 설치 스크립트를 실행하면 SHA-256 체크섬을 검증한 후 ~/.local/bin/pplx에 바이너리를 설치하며, sudo 권한이 필요하지 않습니다. PPLX_INSTALL_PATH 환경 변수로 설치 위치를 바꿀 수도 있습니다1. 현재 지원 플랫폼은 macOS Apple Silicon, Linux x86_64, Linux arm64 세 가지입니다1.
웹 검색을 코드 곁으로 가져오는 이유
요약하면, pplx의 가치는 코딩 에이전트가 실시간 정보를 읽고 코드를 쓰게 하는 파이프라인을 엄격한 출력 규칙과 비용 통제 장치 위에 올려놓은 데 있습니다. Perplexity는 Claude Code나 Codex CLI 같은 에이전트를 위한 Agent Skill도 함께 제공하고 있으므로1, 바로 통합해볼 수 있습니다.
에이전트를 위한 검색 도구는 다양하지만, 컨텍스트 비용을 1순위 설계 요소로 삼고 단일 JSON 규칙으로 파이핑을 보장한 점이 pplx CLI를 선택해야 하는 실용적인 이유입니다.
이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.