Ghid Petdex pentru mascotele Hermes

Ce face

Petdex este capabilitatea Hermes pentru mascote animate: poți răsfoi galeria publică petdex, instala un pet, îl poți selecta ca activ, previzualiza, redimensiona, dezactiva sau elimina.

Un pet instalat reacționează la starea agentului: idle, rulare de tool, review, eroare sau finalizare. Poate apărea în Hermes CLI, TUI și desktop app, dacă suprafața respectivă suportă afișarea.

Petdex nu generează sprite-uri, nu creează mascote noi și nu modifică galeria publică. El controlează comenzile hermes pets și configurația locală display.pet.

Pentru navigare rapidă între ghiduri, vezi All guides.

Când îmi folosește

Folosește Petdex când vrei să personalizezi sau să diagnostichezi mascota Hermes:

• cauți un pet din galeria publică;
• vrei să vezi ce pets sunt deja instalate;
• instalezi o mascotă nouă;
• setezi alt pet ca activ;
• previzualizezi animația în terminal;
• ajustezi dimensiunea;
• dezactivezi sau elimini pet-ul;
• verifici de ce mascota nu apare.

Este o funcție locală de configurare și afișare. Nu trimite mesaje, nu postează extern, nu accesează conturi private și nu cere autentificare pentru galerie.

Cum îl invoc / declanșez

Comenzile canonice sunt prin Hermes CLI:

hermes pets <subcommand>

Instalarea, selectarea, dezactivarea, redimensionarea și ștergerea modifică starea locală Hermes. Verifică slug-ul înainte să instalezi sau să elimini ceva.

Exemplu practic

Flux normal:

1. Cauți un pet: hermes pets list <query>

2. Notezi slug-ul dorit.

3. Îl instalezi și îl activezi: hermes pets install <slug> --select

4. Îl previzualizezi: hermes pets show

5. Oprești preview-ul cu Ctrl+C.

6. Verifici setup-ul: hermes pets doctor

Pentru dimensiune:

hermes pets scale <factor>

Exemplu:

hermes pets scale 0.5

Factorul este limitat între 0.1 și 3.0. Aceeași setare redimensionează mascota pe suprafețele compatibile.

Output / unde aterizează

Pets se instalează în spațiul Hermes al profilului activ:

<HERMES_HOME>/pets/<slug>/

Selectarea unui pet scrie în config.yaml, sub display.pet, cel puțin:

• display.pet.slug
• display.pet.enabled

Configurația relevantă:

• enabled — master on/off;
• slug — pet-ul activ; gol înseamnă primul pet instalat;
• render_mode — auto, kitty, iterm, sixel, unicode sau off;
• scale — dimensiunea pe ecran pentru frame-urile native 192×208; implicit 0.33, limitat la 0.1–3.0;
• unicode_cols — lățimea în coloane pentru fallback-ul Unicode.

hermes pets doctor raportează pet-ul rezolvat, modul de randare configurat, protocolul grafic detectat în terminal și modul efectiv folosit.

Limite / gotchas

Ai nevoie de acces de rețea la petdex.dev pentru galerie și manifest. Accesul este read-only și nu cere autentificare.

Pentru randare terminal full-fidelity, terminalul trebuie să suporte grafică: kitty, Ghostty, WezTerm, iTerm2 sau sixel. Dacă nu, Hermes folosește automat fallback truecolor Unicode half-block.

Un pet apare doar dacă este instalat, selectat și enabled: true.

În pipe sau redirect, fără TTY, randarea în terminal este dezactivată intenționat.

Pillow este necesar pentru decodarea sprite-urilor; în Hermes este dependență de bază.

CLI-ul npm petdex instalează în spațiul Codex, nu în spațiul Hermes. Pentru Hermes, instalează prin hermes pets, nu prin CLI-ul npm.

Verificarea finală este:

hermes pets doctor

Când setup-ul este complet, raportează ✓ ready.