petdex

Install and select animated petdex mascots for the Hermes CLI, TUI, and desktop app.

Updated May 28, 2026
One-click install
npx skills add https://github.com/patty-chow/the-stable --skill petdex-patty-chow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: petdex
Source: https://github.com/patty-chow/the-stable/tree/main/skills/productivity/petdex
Command: npx skills add https://github.com/patty-chow/the-stable --skill petdex-patty-chow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Pillow.

What problem does it solve? Setting up an animated desktop or terminal mascot for Hermes requires manually browsing the petdex gallery, installing sprites into the right profile directory, and configuring rendering options across the CLI, TUI, and desktop app. This Skill wraps that entire workflow into the hermes pets CLI so a pet can be found, installed, previewed, and activated in a few commands. ## Core Features & Use Cases - Gallery browsing and installation: Search the public petdex gallery with hermes pets list <query> and install a mascot with hermes pets install <slug> --select. - Rendering configuration: Control size with hermes pets scale <factor> and choose render modes (kitty, iterm, sixel, unicode, or auto-detect) via display.pet in config.yaml. - Diagnostics: Run hermes pets doctor to verify a pet is installed, selected, enabled, and that Pillow and terminal graphics support are working. - Use Case: A user wants a cat mascot that reacts to agent activity in their terminal. They run hermes pets list cat, install their pick with --select, preview it with hermes pets show, and confirm everything with hermes pets doctor. ## Quick Start Ask the agent to browse the petdex gallery for a pet you like, then install and activate it with hermes pets install <slug> --select and verify the setup using hermes pets doctor.

Frequently Asked Questions about petdex

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install a petdex mascot in Hermes?▼

Run `hermes pets list <query>` to find a pet's slug in the gallery, then run `hermes pets install <slug> --select` to install and activate it. Preview the animation with `hermes pets show` and stop it with Ctrl+C.

How do I resize or change the active Hermes pet?▼

Use `hermes pets scale <factor>` to resize the pet everywhere, clamped between 0.1 and 3.0. Switch the active pet with `hermes pets select <slug>`, or omit the slug to open an interactive picker.

Which terminals support full petdex sprite rendering?▼

Full-fidelity rendering works in graphics-capable terminals: kitty, Ghostty, WezTerm, iTerm2, or any sixel-capable terminal. On other terminals, Hermes automatically falls back to a truecolor Unicode half-block mode.

Why is my Hermes pet not showing in the terminal?▼

A pet only appears after one is installed, selected, and enabled (`display.pet.enabled: true`). Rendering is also disabled inside pipes or redirects without a TTY. Run `hermes pets doctor` to diagnose the exact issue.

Can I use pets installed by the petdex npm CLI with Hermes?▼

No. The petdex npm CLI installs to `~/.codex/pets`, while Hermes uses its own profile-scoped `<HERMES_HOME>/pets/` directory. Install pets through `hermes pets install` so Hermes can find them.