pz

Paperzilla CLI (pz) 用于搜索、过滤和浏览高信号学术论文。当用户想要检查他们的研究提要、列出项目或查找新论文时使用。注意：需要 Paperzilla 帐户。

# Paperzilla CLI (pz) 🦖

A command-line tool for [Paperzilla](https://paperzilla.ai), an AI-powered scientific paper discovery platform.

## Install

macOS:
```bash
brew install paperzilla-ai/tap/pz
```

Windows (Scoop):
```bash
scoop bucket add paperzilla-ai https://github.com/paperzilla-ai/scoop-bucket
scoop install pz
```

Linux:
```bash
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:
```bash
pz login
```

## Core Commands

### List Projects
Lists your available projects and their IDs.
```bash
pz project list
```

### Browse Feed
Fetches the papers for a given project ID.
```bash
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:
```bash
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.):
```bash
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`.
```bash
export PZ_API_URL="https://custom.paperzilla.ai"
```

---

## 中文说明

# Paperzilla CLI (pz) 🦖

[Paperzilla](https://paperzilla.ai) 的命令行工具，Paperzilla 是一个由 AI 驱动的科学论文发现平台。

## 安装

macOS:
```bash
brew install paperzilla-ai/tap/pz
```

Windows (Scoop):
```bash
scoop bucket add paperzilla-ai https://github.com/paperzilla-ai/scoop-bucket
scoop install pz
```

Linux:
```bash
curl -sL https://github.com/paperzilla-ai/pz/releases/latest/download/pz_linux_amd64.tar.gz | tar xz
sudo mv pz /usr/local/bin/
```

## 身份验证

在执行任何操作之前，先使用你的 Paperzilla 帐户登录：
```bash
pz login
```

## 核心命令

### 列出项目
列出你可用的项目及其 ID。
```bash
pz project list
```

### 浏览提要
获取指定项目 ID 的论文。
```bash
pz feed <project-id>
```

**过滤与导出标志：**
- `--must-read` ：仅过滤出必读论文。
- `--limit 5` ：限制返回结果的数量。
- `--since YYYY-MM-DD` ：过滤出在指定日期之后发表的论文。
- `--json` ：以 JSON 格式输出（非常适合用其他工具解析或管道传入 Claude/Gemini）。

示例：
```bash
pz feed 12345 --must-read --limit 5 --json
```

### 提要阅读器集成 (RSS/Atom)
获取一个 Atom 提要 URL，可将其添加到任何提要阅读器（Vienna RSS、NetNewsWire、Feedly 等）：
```bash
pz feed <project-id> --atom
```
这会打印一个带有内嵌提要令牌的 URL。在吊销后再次运行 `--atom` 将生成新令牌。

## API 配置
默认情况下，它连接到 `https://paperzilla.ai`。要覆盖此设置，请设置 `PZ_API_URL`。
```bash
export PZ_API_URL="https://custom.paperzilla.ai"
```