{"skill":{"slug":"paperzilla","displayName":"Paperzilla","summary":"Use the Paperzilla CLI (pz) to browse research projects and feeds, inspect canonical papers and project recommendations, leave feedback, export JSON, and gen...","description":"---\nname: paperzilla\ndescription: 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.\nversion: 0.3.1\nhomepage: https://docs.paperzilla.ai/guides/cli\nmetadata: { \"openclaw\": { \"requires\": { \"bins\": [\"pz\"] }, \"homepage\": \"https://docs.paperzilla.ai/guides/cli\" } }\n---\n\n# Paperzilla CLI (`pz`) 🦖\n\nUse `pz` to read canonical papers, browse project recommendations, inspect projects, leave recommendation feedback, and automate Paperzilla workflows from the terminal.\n\nPrefer `--json` whenever an agent needs structured output.\n\n## Install\n\n### macOS\n```bash\nbrew install paperzilla-ai/tap/pz\n```\n\n### Windows (Scoop)\n```bash\nscoop bucket add paperzilla-ai https://github.com/paperzilla-ai/scoop-bucket\nscoop install pz\n```\n\n### Linux\n```bash\ncurl -sL https://github.com/paperzilla-ai/pz/releases/latest/download/pz_linux_amd64.tar.gz | tar xz\nsudo mv pz /usr/local/bin/\n```\n\n### Build from source (Go 1.23+)\n```bash\ngit clone https://github.com/paperzilla-ai/pz.git\ncd pz\ngo build -o pz .\nmv pz /usr/local/bin/\n```\n\n## Update\n\nFirst check the currently installed version:\n\n```bash\npz --version\n```\n\nThen ask `pz` how it should be upgraded:\n\n```bash\npz update\n```\n\n`pz update` detects common install methods and prints the right upgrade instructions for:\n- Homebrew\n- Scoop\n- GitHub release binaries\n- source builds\n\nIf detection is ambiguous, override it explicitly:\n\n```bash\npz update --install-method homebrew\npz update --install-method scoop\npz update --install-method release\npz update --install-method source\n```\n\nCommon upgrade paths:\n\n### macOS\n```bash\nbrew update\nbrew upgrade pz\n```\n\n### Windows\n```bash\nscoop update pz\n```\n\n### Linux / Releases\n```bash\ncurl -sL https://github.com/paperzilla-ai/pz/releases/latest/download/pz_linux_amd64.tar.gz | tar xz\nsudo mv pz /usr/local/bin/\n```\n\n### Source install\n```bash\ngit pull\ngo build -o pz .\nsudo mv pz /usr/local/bin/\n```\n\n## Authentication\n\n```bash\npz login\n```\n\nYou need login for project-oriented commands like `project`, `feed`, `rec`, and `feedback`.\n\n## Core model: canonical papers vs project recommendations\n\nThis distinction matters:\n- `pz paper <paper-ref>` works with a **canonical Paperzilla paper**\n- `pz rec <project-paper-ref>` works with a **recommendation inside one project**\n\nA canonical paper is shared globally. A recommendation is that paper as it appears in one specific project, with project-specific relevance and feedback.\n\n## Core commands\n\n### Check for updates\n```bash\npz update\n```\n\n### List projects\n```bash\npz project list\n```\n\n### Show one project\n```bash\npz project <project-id>\n```\n\n### Browse project feed\n```bash\npz feed <project-id>\n```\n\nUseful flags:\n- `--must-read`\n- `--since YYYY-MM-DD`\n- `--limit N`\n- `--json`\n- `--atom`\n\nExamples:\n```bash\npz feed <project-id> --must-read --since 2026-03-01 --limit 5\npz feed <project-id> --json\npz feed <project-id> --atom\n```\n\n### Inspect a canonical paper\n```bash\npz paper <paper-id-or-short-id>\npz paper <paper-id-or-short-id> --json\npz paper <paper-id-or-short-id> --markdown\n```\n\nUse `pz paper --project <project-id>` when you want to resolve that canonical paper inside one of your projects and see recommendation context.\n\nExample:\n```bash\npz paper <paper-id> --project <project-id>\n```\n\n### Inspect a project recommendation\n```bash\npz rec <project-paper-id-or-short-id>\npz rec <project-paper-id-or-short-id> --json\npz rec <project-paper-id-or-short-id> --markdown\n```\n\nUse `pz rec` when the identifier came from `pz feed --json`.\n\n### Leave recommendation feedback\n```bash\npz feedback <project-paper-id> upvote\npz feedback <project-paper-id> star\npz feedback <project-paper-id> downvote --reason not_relevant\npz feedback <project-paper-id> downvote --reason low_quality\npz feedback clear <project-paper-id>\n```\n\nFeedback is **project-specific**. The same canonical paper can have different feedback in different projects.\n\n## Output and automation\n\n- Prefer `--json` for machine parsing.\n- Use recommendation IDs from `pz feed --json` with `pz rec` and `pz feedback`.\n- Use canonical paper IDs with `pz paper`.\n- `--atom` returns a personal feed URL for feed readers.\n- `pz rec --markdown` may queue markdown generation if needed.\n- Anonymous `pz paper --markdown` only prints markdown when it is already available.\n\n## Agent usage guidance\n\n- If the user asks to inspect a paper from a project feed, prefer `pz rec` first.\n- If the user asks about the paper as a global/canonical object, use `pz paper`.\n- For scripting, fetch feeds with `--json` and then pass IDs into `pz rec`, `pz feedback`, or `pz paper` as appropriate.\n\n## Configuration\n\n```bash\nexport PZ_API_URL=\"https://paperzilla.ai\"\n```\n\n## References\n\n- Docs: https://docs.paperzilla.ai/guides/cli\n- Quickstart: https://docs.paperzilla.ai/guides/cli-getting-started\n- Repo: https://github.com/paperzilla-ai/pz\n","tags":{"latest":"0.3.1"},"stats":{"comments":0,"downloads":1263,"installsAllTime":48,"installsCurrent":3,"stars":2,"versions":4},"createdAt":1771605315264,"updatedAt":1778491594064},"latestVersion":{"version":"0.3.1","createdAt":1775143177133,"changelog":"Metadata cleanup: align embedded version with published version, add homepage, and normalize OpenClaw dependency metadata for pz.","license":"MIT-0"},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"pors","userId":"s1726anyehf7sx1t7vgh6pjnr183vjsp","displayName":"Mark Pors 🦖","image":"https://avatars.githubusercontent.com/u/1078320?v=4"},"moderation":null}