Paperzilla CLI (pz) 🦖
A command-line tool for Paperzilla, an AI-powered scientific paper discovery platform.
Install
macOS:
brew install paperzilla-ai/tap/pz
Windows (Scoop):
scoop bucket add paperzilla-ai https://github.com/paperzilla-ai/scoop-bucket
scoop install pz
Linux:
curl -sL https://github.com/paperzilla-ai/pz/releases/latest/download/pz_linux_amd64.tar.gz | tar xz
sudo mv pz /usr/local/bin/
Authentication
Log in with your Paperzilla account before doing anything else:
pz login
Core Commands
List Projects
Lists your available projects and their IDs.
pz project list
Browse Feed
Fetches the papers for a given project ID.
pz feed <project-id>
Filter & Export Flags:
--must-read: Filter only for must-read papers.--limit 5: Limit the number of returned results.--since YYYY-MM-DD: Filter papers published after a specific date.--json: Output in JSON format (excellent for parsing with other tools or piping into Claude/Gemini).
Example:
pz feed 12345 --must-read --limit 5 --json
Feed Reader Integration (RSS/Atom)
Get an Atom feed URL you can add to any feed reader (Vienna RSS, NetNewsWire, Feedly, etc.):
pz feed <project-id> --atom
This prints a URL with an embedded feed token. Running --atom again after revoking will generate a new token.
API Configuration
By default, it connects to https://paperzilla.ai. To override, set PZ_API_URL.
export PZ_API_URL="https://custom.paperzilla.ai"
