// the find
crafter-station/petdex
The public gallery of animated pet for Codex, Claude Code, OpenCode y Gemini CLI
Petdex is a community gallery and distribution system for animated pixel-art pets that live inside AI coding agents (Codex, Claude Code, Gemini CLI, OpenCode). You install a pet via `npx petdex install <slug>`, it drops into your agent's config directory, and a floating desktop app reacts to the agent's state in real time. It's for developers who spend all day in an AI CLI and want something alive on their screen.
The pet package format is dead simple — two files, a `pet.json` and a spritesheet on an 8×9 grid — making it easy for anyone to contribute without tooling. The public manifest API (`/api/manifest`) is a genuine stable surface that 21 external projects already build on, which is real validation. The monorepo structure is well-partitioned: Next.js web, Bun CLI, Zig+WebKit macOS floater, Tauri Windows floater, and a Discord bot all live separately with clear boundaries. CLI auth uses PKCE against Clerk, which is the right call for a terminal OAuth flow.
The desktop app is macOS-only for the main Zig build; the Windows version is a separate Tauri package that appears to be in early shape (its `src-tauri/src/lib.rs` is presumably minimal). The spritesheet format is rigid — 8 rows, 9 cols, 192×208 frames, fixed animation states — so any pet with more complex animation needs (more states, variable timing) has no escape hatch. The 70+ one-off backfill and apply scripts in `/scripts` are a red flag: schema evolution has been ad-hoc rather than systematic, suggesting the data model has shifted a lot and will keep shifting. There's no offline install path — `npx petdex install` needs the manifest API, so if petdex.dev goes down, you can't install pets.