June 24, 2026
Petdex: Put a Living Pet on Your Coding Agent (Codex / Claude / Gemini)
Your coding agent works in silence. Petdex fixes that with the most unnecessary-but-delightful tool I've tested this year: a tiny animated pet that lives on your agent and reacts while it codes. I installed one, dug through the real files and the public API, and here's the honest read.
What it is
Petdex is an open-source "Codex pet index" from crafter-station: a web gallery of 3,250+ pixel-art pets, a one-command CLI, and a floating desktop mascot that animates based on what your coding agent is doing — idle, thinking, working, done. It hooks into Codex CLI, Claude Code, Gemini CLI, OpenCode, Antigravity — whatever agents it finds on your machine.
Each pet ships with a 72-frame state viewer — every animation state laid out on a sprite sheet, browsable on the site before you install.
Install
npx petdex # see the CLI
npx petdex list # browse 3,246+ pets
npx petdex install homelander
npx petdex doctor # diagnose agents + install
npx petdex hooks install
doctor is the impressive bit: it scans your machine, lists which coding agents you have, and wires the hooks so the pet actually reacts to agent activity. Everything in the video is a real install on Windows — real terminal output, no faked metrics.
The honest catch
The floating desktop companion — the marquee feature — is macOS-only right now. On Windows you get the CLI, the gallery, the hooks, and terminal-side reactions, but no draggable mascot hovering over your editor. If you're on a Mac, you get the full toy.
What's great / what's rough
Great
- 3,250+ pets, genuinely charming sprite work
- One-command install, zero config
doctorauto-detects your agents and wires hooks- Open source with a clean public API — the sprite and state data is all fetchable, so you can build your own frontend
Rough
- Desktop floater macOS-only (Windows/Linux pending)
- It's a toy — it adds zero capability to your agent
- Young project; expect breaking changes
Verdict
Petdex makes exactly one thing better: the vibe. Your agent runs a 4-minute refactor and instead of a frozen terminal you get a little creature pacing, thinking, celebrating. Useless, wonderful, free. Mac users should just try it — npx petdex doctor and pick a pet. Windows users: star it and wait for the floater.