Petdex is a multi-project suite (web gallery, CLI, and desktop app) for installing and viewing animated Codex pets. It uses Next.js, React, Tailwind, Drizzle, Postgres, Redis, Clerk, and Bun-based CLI. Latest activity shows updates to desktop and CLI, with frequent releases in August 2026.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
Petdex is a project that comprises a web gallery, a CLI, and a desktop app to browse, install, and display animated Codex pets. Pet entries are stored as a folder with a pet.json and a spritesheet, and pets can be installed via a single command. The repository contains three main packages: petdex-cli, petdex-desktop, and discord-bot.
How it works
The web stack uses Next.js 16, React 19, Tailwind, Drizzle, Postgres, Redis, Clerk, and R2. The CLI is built with Bun and TypeScript and ships as a single npm binary; authentication uses Clerk OAuth + PKCE. The desktop client is built with Zig and WebKit, with an HTTP Node-based sidecar for agent hooks. Pet data is exposed via the HTTP API at petdex.dev/api/manifest and pets are packaged as pet.json plus spritesheet.webP or .png.
Getting started
Quick start instructions in the README include:
npx petdex install boba
The desktop app can be downloaded from petdex.dev/download and configured in Settings.
Local development can be started with:
git clone https://github.com/crafter-station/petdex.git
cd petdex
bun install
bun run dev:docker
Open http://localhost:3000 to view the app.
Recent releases
Latest releases include:
- desktop-v0.5.0 (2026-08-05): feat(desktop): activity bubbles per conversation with Sonner-style stack (#657)
- cli-v1.1.0 (2026-08-05): feat(desktop): activity bubbles per conversation with Sonner-style stack (#657)
- cli-v1.0.2 (2026-08-04): fix(download): offer the Intel build, and unbreak bun dev
- desktop-v0.4.0 (2026-08-02): Three new agents, and fix for Windows build usability
- cli-v1.0.1 (2026-08-02): fix(desktop): honor CLAUDE_CONFIG_DIR; feat(desktop): opt-in chime when the pet s
Traction
The repository has 3687 stars and 168 forks.
Behind the repo
No startup or company-specific background is provided beyond the repository authoring organization Crafter Station and a confirmed lead @RaillyHugo.
Caveats
The license is MIT. The README notes a pet assets licensing as user-submitted fan art with takedown workflows, and the codebase includes multiple parts with Docker and Podman setup for local development. Creation and use of pets depend on user-submitted content and the provided packaging format (pet.json and spritesheet).