# Petdex is a gallery of animated pets for coding agents

> Browse, install and submit open-source pets for Codex, Claude Code, Gemini CLI and more.

**Published:** May 2, 2026 | **Area:** Station | **Kind:** Ship | **Crafters:** Railly Hugo

![](https://crafter.run/changelog/petdex/cover.webp)

---

Petdex is the public gallery of animated pets for coding agents. The community submits, reviews and shows pets in the Codex sprite format, and you install one with a single command. It works with Codex, Claude Code, Gemini CLI and more. Browse more than 5,000 pets at [petdex.dev](https://petdex.dev).

<Clip src="/changelog/petdex/states.mp4" poster="/changelog/petdex/states.webp" size="1280x800" alt="Switching a Petdex pet between its waving, jumping, running and failed animations" caption="Every pet has a row of frames for each state your agent can be in." />

## A gallery of pets

Each pet has its own page with a description, tags, collections and a state viewer for idle, running, waving, jumping, failed, waiting and review. Arrow keys browse the dex and the space bar shuffles.

![Petdex home with the install command and a row of featured pets](https://crafter.run/changelog/petdex/home.webp)

*The home page, with the install command for the featured pet.*

## A CLI and a desktop app

The `petdex` CLI installs any pet with one command. Petdex Desktop floats the pet on your screen on macOS, Windows and Linux and animates it on every tool call your agent makes. Agents connect from its settings with one click.

## Used outside Crafter Station

Nous Research added animated pets to Hermes Agent, and the sprites come from the Petdex gallery.

<Mention href="https://decrypt.co/es/372082/tu-agente-hermes-ahora-tiene-una-mascota-que-no-hace-absolutamente-nada-y-ese-es-el-punto" author="Jose Antonio Lanz" source="Decrypt" quote="Los sprites provienen de petdex, una galería comunitaria de código abierto con más de 3.200 opciones para elegir." date="2026-06-25" />

<Mention href="https://hermes-agent.nousresearch.com/docs/user-guide/features/pets" author="Nous Research" source="Hermes Agent docs" quote="Pets come from the public petdex gallery." />

## Try it

```bash
npx petdex install boba
```

Then

---

**Repositories**

- [crafter-station/petdex](https://github.com/crafter-station/petdex)

**Links**

- [Open Petdex](https://petdex.dev)

**Sources**

- https://decrypt.co/es/372082/tu-agente-hermes-ahora-tiene-una-mascota-que-no-hace-absolutamente-nada-y-ese-es-el-punto
- https://hermes-agent.nousresearch.com/docs/user-guide/features/pets
- https://petdex.dev/download
- https://github.com/crafter-station/petdex
- https://www.npmjs.com/package/petdex
- https://github.com/crafter-station/petdex/releases
- https://petdex.dev

**All changes:** [Markdown index](https://crafter.run/en/changelog/sitemap.md) | [Crafter Station](https://crafter.run)
