petdex

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

5|2|Updated May 26, 2026
One-click install
npx skills add https://github.com/perasyudha/Nyxora --skill petdex-perasyudha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: petdex
Source: https://github.com/perasyudha/Nyxora/tree/main/packages/core/playbooks/productivity/petdex
Command: npx skills add https://github.com/perasyudha/Nyxora --skill petdex-perasyudha

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires Pillow.

What problem does it solve? Setting up an animated terminal or desktop mascot normally requires manually downloading sprite packs, configuring rendering protocols, and wiring config files. This Skill streamlines browsing, installing, selecting, and troubleshooting petdex mascots through the nyxora pets CLI. ## Core Features & Use Cases - Gallery Browsing & Installation: Search the public petdex gallery, install pets by slug, and activate them in one command. - Cross-Surface Rendering: The active pet reacts to agent activity (idle, running, reviewing, error, done) across the Nyxora CLI, TUI, and desktop app, with automatic kitty/iTerm/sixel/Unicode fallback rendering. - Diagnostics: nyxora pets doctor verifies the resolved pet, render mode, terminal graphics protocol, and Pillow availability. - Use Case: A user wants a cat mascot in their terminal. Run nyxora pets list cat, install it with --select, preview with nyxora pets show, and confirm setup with nyxora pets doctor. ## Quick Start Ask the agent to browse the petdex gallery, install a pet by slug, and set it as the active mascot using the nyxora pets CLI.

Frequently Asked Questions about petdex

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

FAQPage Schema
How do I install a terminal pet mascot with nyxora pets?

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

How do I change or disable the active petdex mascot?

Use `nyxora pets select <slug>` to switch the active pet, or omit the slug for an interactive picker. Run `nyxora pets off` to disable the pet entirely without removing installed files.

Which terminals support animated pet rendering?

Full-fidelity rendering works in graphics-capable terminals: kitty, Ghostty, WezTerm, iTerm2, or sixel-compatible terminals. On other terminals, a truecolor Unicode half-block fallback is used automatically.

Why is my pet not showing in the terminal?

A pet only displays after one is installed, selected, and enabled in config. Rendering is also disabled inside pipes or redirects without a TTY. Run `nyxora pets doctor` to diagnose the resolved pet, render mode, and detected graphics protocol.

Can I resize the pet mascot across all surfaces?

Yes, run `nyxora pets scale <factor>` with a value clamped between 0.1 and 3.0. One scale setting resizes the pet on the CLI, TUI, and desktop app, and can also be set via the `/pet scale` slash command or the desktop Appearance slider.