Petdex CLI : le catalogue terminal des pets animés pour agents : lecture pratique du dépôt

petdex : Un client de catalogue qui laisse l'affichage à l'application de bureau

La CLI Petdex est un client de catalogue pour les pets animés qui accompagnent les agents de codage. Les pets eux-mêmes sont affichés par Petdex Desktop, une application distincte qui connecte les agents via sa propre fenêtre de réglages ; le rôle de la CLI est de parcourir, installer et soumettre des pets depuis le terminal. Le README renvoie à petdex.dev pour la galerie et la documentation, la page de création des pets y est également, et le code source se trouve sur github.com/crafter-station/petdex. L'introduction clarifie cette division : la CLI est le client de catalogue, l'affichage revient à l'application de bureau. Cela signifie aussi que la CLI n'affiche pas les pets et ne connecte pas les agents ; ces tâches reviennent à la fenêtre de réglages de l'application de bureau. Pour examiner petdex, partez du dépôt crafter-station-petdex-deep-analysis et de uve sur github. Utilisez une entrée propre au projet, notez la sortie produite et contrôlez les fichiers mentionnés par la documentation. Cette vérification doit porter sur petdex, ses versions et ses dépendances réelles, pas sur une démonstration abstraite. Le README ne permet pas d'affirmer une couverture que cette observation ne montre pas. crafter-station/petdex est identifié dans les métadonnées comme un dépôt TypeScript, sous licence MIT. Les chiffres publics et les dates appartiennent au matériau fourni et ne constituent pas une mesure indépendante. Il faut donc distinguer les capacités décrites, les détails laissés ouverts et les hypothèses que votre environnement ajouterait. petdex devient intéressant lorsque son entrée, sa sortie et son mode d'installation correspondent exactement à votre usage. Il convient moins à une équipe qui attend une garantie ou une compatibilité absente du README.

Installation et exigences d'exécution

Le README documente deux chemins d'installation. L'exécution ponctuelle passe par npx avec `npx petdex --help`, sans installation globale ; l'installation globale utilise `npm install -g petdex`. Les deux chemins exigent Node.js 20 ou plus, et le README précise que la CLI fonctionne aussi sous Bun. La source ne spécifie pas de version minimale de Bun, pas de restrictions de système d'exploitation, ni d'autres étapes d'installation que ces deux commandes. Pour éviter l'invite de confirmation de npx, le README suggère `npx -y petdex install <slug>`. Le README note aussi qu'une installation de dépendances qui semble bloquée est presque toujours la barre de progression propre à npm, pas un arbre de sous-dépendances. Pour examiner petdex, partez du dépôt crafter-station-petdex-deep-analysis et de npm install -g petdex`. Utilisez une entrée propre au projet, notez la sortie produite et contrôlez les fichiers mentionnés par la documentation. Cette vérification doit porter sur petdex, ses versions et ses dépendances réelles, pas sur une démonstration abstraite. Le README ne permet pas d'affirmer une couverture que cette observation ne montre pas. crafter-station/petdex est identifié dans les métadonnées comme un dépôt TypeScript, sous licence MIT. Les chiffres publics et les dates appartiennent au matériau fourni et ne constituent pas une mesure indépendante. Il faut donc distinguer les capacités décrites, les détails laissés ouverts et les hypothèses que votre environnement ajouterait. petdex devient intéressant lorsque son entrée, sa sortie et son mode d'installation correspondent exactement à votre usage. Il convient moins à une équipe qui attend une garantie ou une compatibilité absente du README.

La surface de commandes

La CLI expose neuf commandes : login, logout, whoami, list, install, submit, edit, telemetry et --version. login ouvre un navigateur pour l'authentification Clerk OAuth avec PKCE ; logout efface les identifiants locaux ; whoami affiche l'identité connectée ; list liste les pets approuvés de la galerie. install prend un slug et écrit le pet dans ~/.petdex/pets/<slug>/ et ~/.codex/pets/<slug>/. edit s'applique aux pets que l'utilisateur possède et accepte --desc, --displayName, --sprite, --meta et --zip. telemetry gère la télémétrie d'utilisation anonyme, --version affiche la version de la CLI. Le README note aussi que init, up, down, toggle, desktop, update, doctor et hooks ont été retirés en v1.0.0 et ne font plus qu'afficher un renvoi vers l'application de bureau. Pour examiner petdex, partez du dépôt crafter-station-petdex-deep-analysis et de uvre un navigateur pour l'authentification Clerk OAuth avec PKCE ; logout efface les identifiants locaux ; whoami affiche l'identité connectée ; list liste les pets approuvés de la galerie. Utilisez une entrée propre au projet, notez la sortie produite et contrôlez les fichiers mentionnés par la documentation. Cette vérification doit porter sur petdex, ses versions et ses dépendances réelles, pas sur une démonstration abstraite. Le README ne permet pas d'affirmer une couverture que cette observation ne montre pas. crafter-station/petdex est identifié dans les métadonnées comme un dépôt TypeScript, sous licence MIT. Les chiffres publics et les dates appartiennent au matériau fourni et ne constituent pas une mesure indépendante. Il faut donc distinguer les capacités décrites, les détails laissés ouverts et les hypothèses que votre environnement ajouterait. petdex devient intéressant lorsque son entrée, sa sortie et son mode d'installation correspondent exactement à votre usage. Il convient moins à une équipe qui attend une garantie ou une compatibilité absente du README.

Pipeline de soumission et validation

submit accepte trois formes d'entrée : un dossier contenant pet.json et une feuille de sprites, un zip avec la même structure racine, ou un dossier parent dont chaque sous-dossier contenant pet.json est soumis. À chaque soumission, la CLI construit un zip propre en mémoire, appelle POST /api/cli/submit pour obtenir des URL de téléversement Cloudflare R2 présignées avec une durée de vie de 60 secondes, téléverse les fichiers directement vers R2 afin qu'aucun corps ne passe par les serveurs Petdex, puis enregistre la soumission comme pending via POST /api/cli/submit/register. Une barre de progression s'affiche pour chaque pet ; un résumé liste les échecs avec leurs raisons. Les slugs sont dédupliqués automatiquement (boba devient boba-2, boba-3, etc.) pour que les soumissions n'échouent pas sur des collisions. La validation exige une feuille de sprites en grille 8x9 à 1536x1872 ou en grille 8x11 à 1536x2288, ou une mise à l'échelle propre de l'une ou l'autre ; les exports ChatGPT sont déjà au format v2. La limite est de 10 soumissions par 24 heures et par utilisateur, les administrateurs sont exemptés. Pour examiner petdex, partez du dépôt crafter-station-petdex-deep-analysis et de la commande ou le fichier explicitement cité dans ce README. Utilisez une entrée propre au projet, notez la sortie produite et contrôlez les fichiers mentionnés par la documentation. Cette vérification doit porter sur petdex, ses versions et ses dépendances réelles, pas sur une démonstration abstraite. Le README ne permet pas d'affirmer une couverture que cette observation ne montre pas. crafter-station/petdex est identifié dans les métadonnées comme un dépôt TypeScript, sous licence MIT. Les chiffres publics et les dates appartiennent au matériau fourni et ne constituent pas une mesure indépendante. Il faut donc distinguer les capacités décrites, les détails laissés ouverts et les hypothèses que votre environnement ajouterait. petdex devient intéressant lorsque son entrée, sa sortie et son mode d'installation correspondent exactement à votre usage. Il convient moins à une équipe qui attend une garantie ou une compatibilité absente du README.

Authentification

L'authentification utilise OAuth 2.0 Authorization Code avec PKCE (S256) en client public, donc aucun secret client n'est stocké sur la machine. Le rappel local tourne sur un port aléatoire de 127.0.0.1. Les jetons sont stockés dans le trousseau du système sous macOS, Windows et Linux, avec un fichier en chmod 600 en repli quand aucun trousseau n'est disponible. Les jetons d'accès se renouvellent automatiquement via le jeton de rafraîchissement stocké, jusqu'à ce que l'utilisateur exécute logout. Le flux suit l'implémentation de référence @clerk/cli-auth, intégrée au paquet, dont le README donne le lien GitHub. Pour examiner petdex, partez du dépôt crafter-station-petdex-deep-analysis et de uvellent automatiquement via le jeton de rafraîchissement stocké, jusqu'à ce que l'utilisateur exécute logout. Utilisez une entrée propre au projet, notez la sortie produite et contrôlez les fichiers mentionnés par la documentation. Cette vérification doit porter sur petdex, ses versions et ses dépendances réelles, pas sur une démonstration abstraite. Le README ne permet pas d'affirmer une couverture que cette observation ne montre pas. crafter-station/petdex est identifié dans les métadonnées comme un dépôt TypeScript, sous licence MIT. Les chiffres publics et les dates appartiennent au matériau fourni et ne constituent pas une mesure indépendante. Il faut donc distinguer les capacités décrites, les détails laissés ouverts et les hypothèses que votre environnement ajouterait. petdex devient intéressant lorsque son entrée, sa sortie et son mode d'installation correspondent exactement à votre usage. Il convient moins à une équipe qui attend une garantie ou une compatibilité absente du README.

Créer des pets

Le README est explicite : la CLI distribue des pets, elle n'en génère pas. Deux flux sont documentés. Dans l'application de bureau ChatGPT, taper /pet et décrire ce que l'on veut produit un dossier qui peut être soumis directement avec `petdex submit`. Pour un export ChatGPT, la feuille de sprites 1536x2288 est le même atlas que lit Petdex, avec neuf lignes d'états et des nombres de trames correspondants ; le PNG peut être déposé sur petdex.dev/submit, où la grille est mesurée et le pet.json manquant est généré avant qu'on le nomme. Le guide pas à pas complet, avec des conseils, se trouve sur petdex.dev/create. Pour examiner petdex, partez du dépôt crafter-station-petdex-deep-analysis et de uve sur petdex. Utilisez une entrée propre au projet, notez la sortie produite et contrôlez les fichiers mentionnés par la documentation. Cette vérification doit porter sur petdex, ses versions et ses dépendances réelles, pas sur une démonstration abstraite. Le README ne permet pas d'affirmer une couverture que cette observation ne montre pas. crafter-station/petdex est identifié dans les métadonnées comme un dépôt TypeScript, sous licence MIT. Les chiffres publics et les dates appartiennent au matériau fourni et ne constituent pas une mesure indépendante. Il faut donc distinguer les capacités décrites, les détails laissés ouverts et les hypothèses que votre environnement ajouterait. petdex devient intéressant lorsque son entrée, sa sortie et son mode d'installation correspondent exactement à votre usage. Il convient moins à une équipe qui attend une garantie ou une compatibilité absente du README.

Gestion des erreurs, paquetage et licence

Le tableau des modes d'échec du README associe chaque symptôme d'erreur à une cause et à un correctif : sessions expirées, jetons porteurs rejetés, limites de débit, grilles de sprites invalides, fichiers manquants et URL présignées expirées. Les problèmes d'installation courants remontent à l'invite de confirmation propre à npx, aux versions de Node inférieures à 20, aux blocages réseau, aux permissions de répertoire et à un ancien chemin d'installation Windows. La CLI est livrée comme un seul fichier JS groupé, sans dépendances natives, incorporant @clack/prompts, picocolors et jszip ; aucune étape d'installation de dépendances n'est nécessaire sur la machine. La licence est MIT, copyright 2026 Crafter Station ; le texte de licence accorde l'utilisation, la copie, la modification, la fusion, la publication, la distribution, la sous-licence et la vente, et déclare le logiciel fourni en l'état, sans garantie. Il ne dit rien sur le support ni sur la posture de sécurité. Pour examiner petdex, partez du dépôt crafter-station-petdex-deep-analysis et de la commande ou le fichier explicitement cité dans ce README. Utilisez une entrée propre au projet, notez la sortie produite et contrôlez les fichiers mentionnés par la documentation. Cette vérification doit porter sur petdex, ses versions et ses dépendances réelles, pas sur une démonstration abstraite. Le README ne permet pas d'affirmer une couverture que cette observation ne montre pas. crafter-station/petdex est identifié dans les métadonnées comme un dépôt TypeScript, sous licence MIT. Les chiffres publics et les dates appartiennent au matériau fourni et ne constituent pas une mesure indépendante. Il faut donc distinguer les capacités décrites, les détails laissés ouverts et les hypothèses que votre environnement ajouterait. petdex devient intéressant lorsque son entrée, sa sortie et son mode d'installation correspondent exactement à votre usage. Il convient moins à une équipe qui attend une garantie ou une compatibilité absente du README.

Conclusion éditoriale

Le README documente l'installation, la soumission, la validation et l'authentification de la CLI Petdex avec assez de détail pour reproduire ces flux sans l'application de bureau. L'application de bureau, la galerie et le guide de création sont des surfaces distinctes, accessibles via petdex.dev. petdex convient à une équipe qui peut suivre les contraintes décrites dans crafter-station/petdex et vérifier une sortie propre à son cas. Avant adoption, exécutez la commande ou ouvrez le fichier cité par le README, puis contrôlez la version, les dépendances et la licence MIT selon votre mode de distribution.

Sources officielles

1. Official documentation
2. Official README
3. Project repository
4. Release notes