skills.rest
hugotown
hugotownCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

petdex

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

Updated Oct 16, 2025
Search Tags:#cli#customization#terminal#animation#mascot#hermes#petdex
One-click install
npx skills add https://github.com/hugotown/dotfiles --skill petdex-hugotown
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: petdex
Source: https://github.com/hugotown/dotfiles/tree/main/hermes/skills/productivity/petdex
Command: npx skills add https://github.com/hugotown/dotfiles --skill petdex-hugotown

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Pillow.

What problem does it solve? Users who want an animated mascot in their Hermes terminal or desktop environment need a way to browse, install, activate, and troubleshoot pets without manually managing sprite files or configuration keys. ## Core Features & Use Cases - Gallery browsing and installation: Search the public petdex gallery with hermes pets list <query> and install pets by slug into the profile-scoped <HERMES_HOME>/pets/ directory. - Activation and rendering control: Select the active pet, scale it from 0.1 to 3.0, preview animations per state, and choose render modes (kitty, iterm, sixel, unicode, or auto-detect). - Diagnostics: Run hermes pets doctor to verify a pet is installed, selected, enabled, and that Pillow is importable, plus detect the terminal graphics protocol. - Use Case: A user on Ghostty runs hermes pets install cat --select, previews it with hermes pets show --cycle, and confirms rendering with hermes pets doctor. ## Quick Start Ask the agent to install and activate a petdex pet by slug, for example: install the cat pet from petdex and make it my active Hermes mascot.

Frequently Asked Questions about petdex

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

FAQPage Schema
How do I install and activate a petdex pet in Hermes?▼

Run `hermes pets list <query>` to find a pet's slug, then `hermes pets install <slug> --select` to install and activate it in one step. Preview it with `hermes pets show` and confirm setup with `hermes pets doctor`.

How do I resize the Hermes pet mascot?▼

Use `hermes pets scale <factor>` with a value clamped between 0.1 and 3.0, such as 0.5. The same setting is available via the `/pet scale` slash command or the desktop Appearance slider, and it resizes the pet on every surface.

Which terminals support full-fidelity petdex rendering?▼

Graphics-capable terminals include kitty, Ghostty, WezTerm, iTerm2, and sixel-compatible terminals. On other terminals, Hermes automatically falls back to a truecolor Unicode half-block rendering mode.

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

A pet only displays when one is installed, selected, and `enabled` is true under `display.pet` in config.yaml. Rendering is also disabled by design inside pipes or redirects without a TTY; run `hermes pets doctor` to diagnose the exact cause.

Does the petdex npm CLI work with Hermes pets?▼

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

Related Skills

Explore More Personal & Entrepreneur Skills→
davpatel605-beepdavpatel605-beep

petdex

Manage installation and selection of animated pet mascots for Hermes environments.

Community
Intermediate
patty-chowpatty-chow

petdex

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

Community
Basic
escapevelocitylabsescapevelocitylabs

build-checklists

Generate packing, pre-trip, and day-of checklists from trip configuration files.

Official
Intermediate
NeuroSkill-comNeuroSkill-com
11

neuroskill-protocols-sleep

Guide sleep, circadian, and recovery protocols using NeuroLoop EXG metrics and commands.

Official
Intermediate