petdex

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

6|Updated Jul 12, 2026
One-click install
npx skills add https://github.com/josoroma/AppLoop --skill petdex-josoroma
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: petdex
Source: https://github.com/josoroma/AppLoop/tree/main/.hermes/skills/productivity/petdex
Command: npx skills add https://github.com/josoroma/AppLoop --skill petdex-josoroma

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up an animated desktop or terminal mascot for Hermes requires manually finding pet sprites, installing them into the right profile directory, and configuring rendering options. This Skill drives the hermes pets CLI so you can browse, install, select, and troubleshoot petdex mascots without editing config files by hand. ## Core Features & Use Cases - Gallery browsing and installation: Search the public petdex gallery with hermes pets list <query> and install a pet with hermes pets install <slug> --select. - Display configuration: Control the active pet, render mode (kitty, iTerm, sixel, Unicode fallback), and scale via the display.pet section of config.yaml or the hermes pets scale command. - Diagnostics: Run hermes pets doctor to verify a pet is installed, selected, enabled, and that Pillow is importable. - Use Case: You want a cat mascot that reacts to agent activity in your terminal. Run hermes pets list cat, install your choice with --select, preview it with hermes pets show, and confirm the setup with hermes pets doctor. ## Quick Start Ask the agent to browse the petdex gallery for a pet you like, install it with the select flag, and run the doctor command to confirm it is active.

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 pet in Hermes?▼

Run `hermes pets install <slug> --select` to download a pet from the petdex gallery and make it active in one step. Find slugs first with `hermes pets list <query>`, then preview the result with `hermes pets show`.

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

Use `hermes pets select <slug>` to switch the active pet, or omit the slug for an interactive picker. Run `hermes pets off` to disable the pet entirely without uninstalling it.

Which terminals support full-fidelity petdex rendering?▼

Graphics-capable terminals such as kitty, Ghostty, WezTerm, iTerm2, and sixel-supporting terminals render pets at full fidelity. Other terminals automatically fall 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 in the display.pet config. Rendering is also disabled inside pipes or redirects without a TTY; run `hermes pets doctor` to check the resolved pet, render mode, and detected graphics protocol.

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.