paperzilla

¿Qué hace paperzilla?

Usa esta habilidad cuando quieras charlar con tu agente sobre proyectos, recomendaciones y artículos canónicos en Paperzilla.

Qué puedes preguntar

• "Dame las últimas recomendaciones del proyecto X."
• "Abre la recomendación Y y explica por qué es importante."
• "Obtén el artículo canónico Z en markdown y resúmelo."
• "Dime cómo este artículo se relaciona con mi investigación."
• "Muéstrame el feed del proyecto X."
• "Deja retroalimentación sobre una recomendación."
• "Exporta este artículo, recomendación o feed como JSON."

Esta es la habilidad central de Paperzilla. Le da a tu agente acceso directo a los datos de Paperzilla, pero no impone un flujo de trabajo ni integración externa de entrega.

Método de acceso

La mayoría de los perfiles actuales en este repositorio usan la CLI pz.

Si el perfil actual incluye instrucciones adicionales específicas del agente, síguelas también.

Instalación

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

Usa la guía oficial de instalación para Linux:

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

Compilar desde el código fuente (Go 1.23+)

Consulta el repositorio de la CLI para compilaciones desde fuente:

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

Actualización

Verifica si tu CLI está actualizada y obtén pasos de actualización específicos para tu instalación:

pz update

Si la detección es ambigua, sobrescríbela explícitamente:

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

Los valores admitidos son auto, homebrew, scoop, release y source.

Autenticación

pz login

Referencia de la CLI

Si el perfil actual usa pz, estos son los comandos principales.

Listar proyectos

pz project list

Mostrar un proyecto

pz project <project-id>

Navegar por el feed de un proyecto

pz feed <project-id>

Banderas útiles:

• --must-read
• --since YYYY-MM-DD
• --limit N
• --json
• --atom

Ejemplos:

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

La salida del feed puede incluir marcadores de retroalimentación de recomendaciones existentes:

• [↑] voto positivo
• [↓] voto negativo
• [★] estrella

Leer un artículo canónico

pz paper <paper-id>
pz paper <paper-id> --json
pz paper <paper-id> --markdown
pz paper <paper-id> --project <project-id>

Abrir una recomendación de uno de tus proyectos

pz rec <project-paper-id>
pz rec <project-paper-id> --json
pz rec <project-paper-id> --markdown

Dejar retroalimentación sobre una recomendación

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>

Salida y automatización

• Prefiere --json para procesamiento automático.
• pz paper --markdown solo devuelve markdown cuando ya está preparado.
• pz rec --markdown puede poner en cola la generación de markdown e imprime un mensaje amigable para reintentar mientras se está preparando.
• --atom devuelve una URL de feed personal para lectores de feeds.

Configuración

export PZ_API_URL="https://paperzilla.ai"

Referencias

• Docs: https://docs.paperzilla.ai/guides/cli
• Quickstart: https://docs.paperzilla.ai/guides/cli-getting-started
• Repo: https://github.com/paperzilla-ai/pz