O que paperzilla faz?
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
A maioria dos perfis atuais neste repositório usa a CLI pz.
Se o perfil atual incluir instruções extras específicas do agente, siga-as também.
Instalação
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
Use o guia oficial de instalação para Linux:
Compilar a partir do código-fonte (Go 1.23+)
Veja o repositório da CLI para compilações a partir do código-fonte:
Atualização
Verifique se sua CLI está atualizada e veja as etapas de atualização específicas do método de 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
Referência da CLI
Se o perfil atual usar pz, estes são os comandos principais.
Listar projetos
pz project list
Mostrar um projeto
pz project <project-id>
Navegar pelo feed do projeto
pz feed <project-id>
Flags úteis:
--must-read--since YYYY-MM-DD--limit N--json--atom
Exemplos:
pz feed <project-id> --must-read --since 2026-03-01 --limit 5
pz feed <project-id> --json
pz feed <project-id> --atom
A saída do feed pode incluir marcadores de feedback de recomendações existentes:
[↑]upvote[↓]downvote[★]estrela
Ler um artigo canônico
pz paper <paper-id>
pz paper <paper-id> --json
pz paper <paper-id> --markdown
pz paper <paper-id> --project <project-id>
Abrir uma recomendação de um dos seus projetos
pz rec <project-paper-id>
pz rec <project-paper-id> --json
pz rec <project-paper-id> --markdown
Deixar feedback sobre uma recomendação
pz feedback <project-paper-id> upvote
pz feedback <project-paper-id> star
pz feedback <project-paper-id> downvote --reason not_relevant
pz feedback clear <project-paper-id>
Saída e automação
- Prefira
--jsonpara análise por máquina. pz paper --markdownretorna markdown apenas quando já estiver preparado.pz rec --markdownpode enfileirar a geração de markdown e imprime uma mensagem amigável de nova tentativa enquanto ainda está sendo preparado.--atomretorna uma URL de feed pessoal para leitores de feed.
Configuração
export PZ_API_URL="https://paperzilla.ai"
Referências
- Documentação: https://docs.paperzilla.ai/guides/cli
- Guia de início rápido: https://docs.paperzilla.ai/guides/cli-getting-started
- Repositório: https://github.com/paperzilla-ai/pz