Paperzilla
by @pors
Use the Paperzilla CLI (pz) to browse research projects and feeds, inspect canonical papers and project recommendations, leave feedback, export JSON, and gen...
clawhub install paperzillaπ About This Skill
name: paperzilla description: Use the Paperzilla CLI (pz) to browse research projects and feeds, inspect canonical papers and project recommendations, leave feedback, export JSON, and generate Atom feed URLs. Trigger when users ask to check Paperzilla feeds, list projects, inspect paper details, tune recommendations, or automate feed workflows. version: 0.3.1 homepage: https://docs.paperzilla.ai/guides/cli metadata: { "openclaw": { "requires": { "bins": ["pz"] }, "homepage": "https://docs.paperzilla.ai/guides/cli" } }
Paperzilla CLI (pz) π¦
Use pz to read canonical papers, browse project recommendations, inspect projects, leave recommendation feedback, and automate Paperzilla workflows from the terminal.
Prefer --json whenever an agent needs structured output.
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/
Build from source (Go 1.23+)
git clone https://github.com/paperzilla-ai/pz.git
cd pz
go build -o pz .
mv pz /usr/local/bin/
Update
First check the currently installed version:
pz --version
Then ask pz how it should be upgraded:
pz update
pz update detects common install methods and prints the right upgrade instructions for:
If detection is ambiguous, override it explicitly:
pz update --install-method homebrew
pz update --install-method scoop
pz update --install-method release
pz update --install-method source
Common upgrade paths:
macOS
brew update
brew upgrade pz
Windows
scoop update pz
Linux / Releases
curl -sL https://github.com/paperzilla-ai/pz/releases/latest/download/pz_linux_amd64.tar.gz | tar xz
sudo mv pz /usr/local/bin/
Source install
git pull
go build -o pz .
sudo mv pz /usr/local/bin/
Authentication
pz login
You need login for project-oriented commands like project, feed, rec, and feedback.
Core model: canonical papers vs project recommendations
This distinction matters:
pz paper works with a canonical Paperzilla paperpz rec works with a recommendation inside one projectA canonical paper is shared globally. A recommendation is that paper as it appears in one specific project, with project-specific relevance and feedback.
Core commands
Check for updates
pz update
List projects
pz project list
Show one project
pz project
Browse project feed
pz feed
Useful flags:
--must-read--since YYYY-MM-DD--limit N--json--atomExamples:
pz feed --must-read --since 2026-03-01 --limit 5
pz feed --json
pz feed --atom
Inspect a canonical paper
pz paper
pz paper --json
pz paper --markdown
Use pz paper --project when you want to resolve that canonical paper inside one of your projects and see recommendation context.
Example:
pz paper --project
Inspect a project recommendation
pz rec
pz rec --json
pz rec --markdown
Use pz rec when the identifier came from pz feed --json.
Leave recommendation feedback
pz feedback upvote
pz feedback star
pz feedback downvote --reason not_relevant
pz feedback downvote --reason low_quality
pz feedback clear
Feedback is project-specific. The same canonical paper can have different feedback in different projects.
Output and automation
--json for machine parsing.pz feed --json with pz rec and pz feedback.pz paper.--atom returns a personal feed URL for feed readers.pz rec --markdown may queue markdown generation if needed.pz paper --markdown only prints markdown when it is already available.Agent usage guidance
pz rec first.pz paper.--json and then pass IDs into pz rec, pz feedback, or pz paper as appropriate.Configuration
export PZ_API_URL="https://paperzilla.ai"
References
βοΈ Configuration
export PZ_API_URL="https://paperzilla.ai"