# crafter-station/petdex

A public gallery of animated pets for Codex, Claude Code, DeepSeek Harness, Hermes, OpenCode, Gemini CLI, and more.

Repository: https://github.com/crafter-station/petdex
Canonical: https://ross.abutalabs.com/products/petdex
Homepage: https://petdex.dev
Language: TypeScript
License: MIT
License Family: permissive
Topics: claude-code, clerk, cli, codex, developer-tools, drizzle-orm, mascot, neon, nextjs, pixel-art, postgres, react, sprites, tailwindcss, vercel, dsh-plugin
Last push: 2026-08-26T04:16:02+00:00

## Health v2 (maintenance only)
Score: 80/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 98, longevity 8
- inputs: {"age_days": 123, "days_push": 7, "days_rel": 19, "gap_med": 0.0, "n_releases_24m": 29}
- flags: young
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3981, forks 190 (observed 2026-08-28T04:08:31.010620+00:00)

## What it is
Petdex is a public gallery of animated pixel-art pets (mascots) for coding agents like Codex, Claude Code, and Gemini CLI, consisting of a web gallery, an npm CLI for installing pets, and a cross-platform desktop app that floats the pet on screen and animates it in response to agent tool calls. Pets are community-submitted sprite folders installed with a single `npx petdex install` command.

## Use cases
- add an animated desktop pet to my coding agent
- install a pixel-art mascot for Codex
- browse a gallery of community-submitted desktop pets
- make my terminal agent show a fun companion while it works
- submit my own animated pet sprite to a public index
- get a desktop mascot that reacts to AI agent tool calls

## When to choose
- you want a fun, animated companion that reacts to your coding agent's activity
- you want a one-command install of community pixel-art pets
- you want a cross-platform desktop floater for macOS, Linux, or Windows
- you want to browse or contribute to a large open pet sprite gallery

## When to avoid
- you need a serious productivity or monitoring tool rather than a cosmetic mascot
- you don't use a supported coding agent like Codex or Claude Code
- you need offline-only operation without a gallery or CLI dependency

## Facets
- artifact type: application
- maturity: active
- function: cli, gui, developer-tools, animation, ui-components
- domain: developer-tools, desktop-applications, gaming-tools, entertainment
- platform: windows, bun, cli, cross-platform
- tags: desktop-pet, mascot, pixel-art, sprites, coding-agents, codex, claude-code, pet-gallery, fun, nextjs, command-line, macos, linux, nodejs, desktop

## Member repositories
- crafter-station/petdex (main) score 80

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:31.010620+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:24:16.713127+00:00, confidence not recorded.
  - readme: https://github.com/crafter-station/petdex (fetched 2026-08-28T04:08:31.010620+00:00, sha ed02f7a6251d)
  - homepage: https://petdex.dev (fetched 2026-08-29T09:17:50.453489+00:00, sha 496bd784e68b)
  - site_page: https://petdex.dev/docs (fetched 2026-08-29T09:17:50.456090+00:00, sha 20888c7aca32)
  - registry_npm: https://registry.npmjs.org/petdex (fetched 2026-08-29T09:17:50.458422+00:00, sha 165aa1bb8d51)
- Data as of 2026-08-30T08:39:29.467469+00:00.