petdex
A public gallery of animated pets for Codex, Claude Code, DeepSeek Harness, Hermes, OpenCode, Gemini CLI, and more.
What is petdex?
A public gallery of animated pets for Codex, Claude Code, DeepSeek Harness, Hermes, OpenCode, Gemini CLI, and more.
Overview of petdex
What it is
Petdex is a public gallery of animated pets for coding agents such as Codex, Claude Code, DeepSeek Harness, Hermes, OpenCode, and Gemini CLI. It consists of three components: a web gallery at petdex.dev where the community submits, reviews, and showcases animated pets in the Codex sprite format; a CLI that installs any pet on a machine with one command and ships them into Codex; and a desktop app that floats a pet on the screen and reacts to the coding agent's activity in real time. Every pet is a folder containing a pet.json metadata file and a spritesheet.
Key features
- Web gallery for browsing, submitting, and reviewing animated pets.
- CLI command
npx petdex installto install a pet directly into Codex. - Desktop app that displays a floating pet and animates on each tool call made by the coding agent.
- Personal collections: signed-in creators can group approved pets into collections via the profile's Collections tab or the CLI (
npx petdex collection create). - HTTP API at
petdex.dev/api/manifestthat returns every approved pet with its slug, spritesheet URL, animation states, and metadata. - Pet package format: a
pet.jsonplus a spritesheet rendered as an 8x9 or v2 8x11 grid of 192x208 pixel frames. - Support for multiple coding agents: Codex, Claude Code, DeepSeek Harness, Hermes, OpenCode, Gemini CLI, and more.
Use cases
- Developers using coding agents who want an animated companion to visualize agent activity.
- Community members sharing and discovering fan-made pet sprites.
- Builders integrating the pet system into other projects via the HTTP API or the pet package format.
- Managing personal collections of favorite pets.
Getting started
Install a known pet with the CLI: sh npx petdex install boba Then download the desktop app from petdex.dev/download. Open the app, press Cmd+, to open Settings, select a pet under Pets, and connect coding agents under Agents. Signed-in creators can also create collections: sh npx petdex collection create --title 'My pets' --pets boba,mochi
License and pricing
The source code is licensed under MIT. Pet assets are owned by their submitters under whatever license they choose to declare. The project is open source and free to use.
Based on the project's public README and repository metadata.