A Pokédex for your AI coding companion's desk pet

What it does

Petdex is a public gallery and package manager for animated pixel-art pets made for AI coding agents like Codex. It hosts a web gallery where the community submits and reviews sprites, ships a CLI that installs pets locally, and bundles a desktop app that floats the sprite above your screen. The pets react to agent activity—think idle, run, failed, and review states—so your coding session gets a tiny, anxious roommate.

The interesting bit

The project treats every pet like a standardized software package: each is just a pet.json manifest plus an 8×9 spritesheet grid that maps animation rows to agent hooks. The desktop floater is built in Zig and WebKit rather than Electron, which is either admirably restrained or a flex, depending on your worldview.

Key highlights

• Curated community gallery with submission review and takedown process
• Single-binary CLI for browsing, installing, and submitting pets
• Desktop floater with real-time agent activity hooks
• Stable HTTP API and documented package format for third-party integrations
• Pet assets remain the submitters’ property; the project disclaims IP ownership

Caveats

• Desktop app ships as a .dmg built with Zig and WebKit; the README never mentions Windows or Linux builds
• Pet assets are user-submitted fan art with no unified license; the project runs a takedown process but does not police underlying IP
• The repo description lists Claude Code, OpenCode, and Gemini CLI support, yet the README only explains Codex integration

Verdict

A welcome distraction for Codex users who miss the era of desktop mascots. Everyone else—including Windows and Linux desktop users—can safely keep walking.