skills.rest
brittb-dev
brittb-devCOMMUNITY
Explore all skills by this author →
GitHub

petdex

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

1|Updated Feb 17, 2026
Search Tags:#cli#customization#terminal#animation#desktop#mascot#petdex
One-click install
npx skills add https://github.com/brittb-dev/zerogravityclaw --skill petdex-brittb-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: petdex
Source: https://github.com/brittb-dev/zerogravityclaw/tree/main/src/hermes-core/skills/productivity/petdex
Command: npx skills add https://github.com/brittb-dev/zerogravityclaw --skill petdex-brittb-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Pillow.

What problem does it solve? Users who want an animated desktop or terminal mascot that reacts to agent activity need a way to browse, install, and configure pets without manually managing sprite files or config entries. ## Core Features & Use Cases - Gallery Browsing and Installation: Search the public petdex gallery, install pets by slug into the profile-scoped HERMES_HOME directory, and activate them in one command. - Rendering Configuration: Control render mode (kitty, iterm, sixel, unicode, auto), scale, and enablement through the display.pet section of config.yaml. - Diagnostics: Run hermes pets doctor to verify a pet is installed, selected, enabled, and that Pillow is importable. - Use Case: A user wants a cat mascot in their terminal that animates while the agent runs tools. They run hermes pets list cat, install the chosen slug with --select, preview it with hermes pets show, and confirm setup with hermes pets doctor. ## Quick Start Ask the agent to browse the petdex gallery for a pet, install it with selection enabled, and preview the animation in the terminal.

Frequently Asked Questions about petdex

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

FAQPage Schema
How do I install an animated terminal pet with petdex?▼

Run hermes pets list to browse the gallery, note the pet's slug, 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 the petdex mascot in the terminal?▼

Use hermes pets scale <factor> with a value clamped between 0.1 and 3.0, such as 0.5. The same scale applies across the CLI, TUI, and desktop app, and can also be set via the /pet scale slash command or the desktop Appearance slider.

Which terminals support full-fidelity petdex rendering?▼

Graphics-capable terminals including 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 petdex pet not showing in the terminal?▼

A pet only displays after one is installed and selected with enabled set to true. Rendering is also disabled by design inside pipes or redirects without a TTY. Run hermes pets doctor to diagnose the resolved pet, render mode, and detected graphics protocol.

Does the petdex npm CLI install location work 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 so Hermes can resolve and render them.

Related Skills

Explore More Personal & Entrepreneur Skills→
josoromajosoroma
6

petdex

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

Community
Basic
AtlasOmniaAtlasOmnia
115

hermes-themes

Create and apply YAML color themes for the Hermes CLI, TUI, and desktop GUI.

Community
Intermediate
humanerd-drewhumanerd-drew
2

agent-dashboard-cf

Display system metrics, activity logs, and error management for an AI agent.

Official
Advanced
hugotownhugotown

petdex

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

Community
Basic