Paperzilla

Use esta habilidade quando quiser conversar com seu agente sobre projetos, recomendações e artigos canônicos no Paperzilla.

O que você pode perguntar

• "Me dê as últimas recomendações do projeto X."
• "Abra a recomendação Y e explique por que ela é importante."
• "Busque o artigo canônico Z como markdown e resuma-o."
• "Diga-me como este artigo é relevante para minha pesquisa."
• "Mostre-me o feed do projeto X."
• "Deixe feedback sobre uma recomendação."
• "Exporte este artigo, recomendação ou feed como JSON."

Esta é a habilidade principal do Paperzilla. Ela dá ao seu agente acesso direto aos dados do Paperzilla, mas não impõe um fluxo de trabalho ou integração de entrega externa.

Método de acesso

Use a CLI oficial pz. Esta habilidade tem como alvo a versão 0.7.1, verificada contra a fonte oficial e o binário da versão. Exemplos de comandos usam IDs de espaço reservado; substitua-os pelos registros retornados pela sua conta. O comportamento da CLI foi testado contra um servidor mock local, não uma conta Paperzilla autenticada.

Comece com pz --version, depois liste os projetos, selecione um projeto, navegue ou pesquise seu feed e inspecione as recomendações selecionadas. Mantenha as recomendações do projeto separadas do artigo canônico subjacente ao resumir ou exportar.

Instalar

macOS

brew install paperzilla-ai/tap/pz

Se o Homebrew 6 ou posterior rejeitar esta fórmula como não confiável, o guia oficial usa brew trust --formula paperzilla-ai/tap/pz, e então tenta a instalação novamente. Confie apenas nessa fórmula. Os comandos de instalação e atualização foram verificados na documentação, mas não executados durante esta revisão.

Windows (Scoop)

scoop bucket add paperzilla-ai https://github.com/paperzilla-ai/scoop-bucket
scoop install pz

Linux

Use o guia oficial de instalação para Linux:

• https://docs.paperzilla.ai/guides/cli-getting-started

Compilar do código fonte (Go 1.23+)

Veja o repositório da CLI para compilações a partir do código fonte:

• https://github.com/paperzilla-ai/pz

Atualizar

Verifique se sua CLI está atualizada e obtenha as etapas de atualização específicas da instalação:

pz update

Se a detecção for ambígua, substitua-a explicitamente:

pz update --install-method homebrew
pz update --install-method scoop
pz update --install-method release
pz update --install-method source

Os valores suportados são auto, homebrew, scoop, release e source.

Autenticação

pz login

O login envia um código único para o e-mail da conta e salva a sessão localmente. Conclua-o interativamente antes de executar exportações JSON: credenciais ausentes ou expiradas podem acionar prompts de login no stdout. A CLI verifica o acesso à conta e atualiza tokens automaticamente; relate erros de acesso/atualização em vez de tratados como um feed vazio.

Discrepância específica da versão: os guias online descrevem o acesso anônimo a artigos canônicos, mas o binário 0.7.1 requer login e uma verificação de acesso CLI mesmo para pz paper. Sua solicitação HTTP subsequente de artigo canônico usa uma rota pública. Não prometa um fluxo de trabalho CLI anônimo para esta versão.

Referência da CLI

Se o perfil atual usar pz, estes são os comandos principais.

Listar projetos

pz project list
pz project list --json

Mostrar um projeto

pz project <project-id>
pz project <project-id> --json

O JSON da lista é um array contendo id, name, mode e visibility. O JSON de projeto único também inclui palavras-chave, fontes monitoradas e categorias.

Navegar pelo feed do projeto

pz feed <project-id>

Flags úteis:

• --must-read
• --since YYYY-MM-DD
• --limit N
• --offset N (resultados baseados em zero a serem ignorados)
• --json
• --atom

Exemplos:

pz feed <project-id> --must-read --since 2026-03-01 --limit 5
pz feed <project-id> --limit 20 --offset 20 --json
pz feed <project-id> --json
pz feed <project-id> --atom

--since filtra quando as recomendações estavam prontas, não a data de publicação do artigo. O JSON de navegação contém items, total, limit e offset. Um comando busca uma página; ele não exporta o feed inteiro automaticamente. Mantenha os mesmos filtros, avance do deslocamento retornado pelo número de itens recebidos e pare em uma página vazia ou quando o total retornado for atingido. Deduplique por ID de recomendação se o feed ao vivo mudar durante a paginação.

A saída do feed pode incluir marcadores de feedback de recomendação existentes:

• [↑] para cima
• [↓] para baixo
• [★] estrela

Pesquisar o feed completo do projeto

pz feed search --project-id <project-id> --query "latent retrieval" --json

…