paperzilla

Que fait paperzilla ?

Utilisez cette compétence lorsque vous souhaitez discuter avec votre agent de projets, recommandations et articles canoniques dans Paperzilla.

Ce que vous pouvez demander

• "Donne-moi les dernières recommandations du projet X."
• "Ouvre la recommandation Y et explique pourquoi elle est importante."
• "Récupère l'article canonique Z au format Markdown et résume-le."
• "Dis-moi en quoi cet article est pertinent pour ma recherche."
• "Affiche le flux du projet X."
• "Laisse un retour sur une recommandation."
• "Exporte cet article, cette recommandation ou ce flux au format JSON."

Ceci est la compétence principale de Paperzilla. Elle donne à votre agent un accès direct aux données Paperzilla, mais n'impose pas de workflow ni d'intégration de livraison externe.

Méthode d'accès

La plupart des profils actuels de ce dépôt utilisent l'interface en ligne de commande pz.

Si le profil actuel fournit des instructions supplémentaires spécifiques à l'agent, suivez-les également.

Installation

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

Utilisez le guide d'installation officiel pour Linux :

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

Compilation à partir des sources (Go 1.23+)

Consultez le dépôt CLI pour les compilations à partir des sources :

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

Mise à jour

Vérifiez si votre CLI est à jour et obtenez les étapes de mise à niveau spécifiques à l'installation :

pz update

Si la détection est ambiguë, remplacez-la explicitement :

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

Les valeurs prises en charge sont auto, homebrew, scoop, release et source.

Authentification

pz login

Référence CLI

Si le profil actuel utilise pz, voici les commandes principales.

Lister les projets

pz project list

Afficher un projet

pz project <project-id>

Parcourir le flux d'un projet

pz feed <project-id>

Indicateurs utiles :

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

Exemples :

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

Le résultat du flux peut inclure des marqueurs de retour sur les recommandations existantes :

• [↑] vote positif
• [↓] vote négatif
• [★] étoile

Lire un article canonique

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

Ouvrir une recommandation depuis l'un de vos projets

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

Laisser un retour sur une recommandation

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>

Sortie et automatisation

• Privilégiez --json pour l'analyse automatique.
• pz paper --markdown ne renvoie le Markdown que s'il est déjà préparé.
• pz rec --markdown peut mettre en file d'attente la génération du Markdown et affiche un message de réessai convivial pendant sa préparation.
• --atom renvoie une URL de flux personnel pour les lecteurs de flux.

Configuration

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

Références

• Documentation : https://docs.paperzilla.ai/guides/cli
• Guide de démarrage rapide : https://docs.paperzilla.ai/guides/cli-getting-started
• Dépôt : https://github.com/paperzilla-ai/pz