PawPause
Wellness companion that keeps a Petdex pet on screen and nudges you to pause, hydrate, and stay focused.
Built with Petdex
Real projects. Real integrations.
An editorial field guide to 30 open-source and source-available products built with Petdex. See what they ship, how they integrate, and where they are headed.
30
Projects
6
Categories
288.7K
Combined stars
08.30
Updated
Site
The ecosystem field guide
Explore by chapter
Browse the Petdex ecosystem by category. Each chapter highlights what builders ship and how they bring Petdex to life.
01
Wellness & focus
Pomodoros, breaks, and focus tools that use Petdex pets as their on-screen character.
View all (2)02
Desktop companions
Apps that put a Petdex pet on your desktop.
View all (17)03
Wearable
Petdex pets running on Apple Watch, Garmin, and other wearables.
View all (2)04
SDKs & runtimes
Libraries and runtimes that wrap the Petdex API or pet format for other platforms.
View all (2)05
Bundled in larger apps
Petdex pets shipped as a feature of bigger products.
View all (5)06
Pet creators
Solo creators distributing original pets in Petdex package format.
View all (2)Every verified project
The complete field guide
Every listing links to public evidence showing how the project uses the Petdex gallery, API, or pet format.
Chapter 01
Wellness & focus
Pomodoros, breaks, and focus tools that use Petdex pets as their on-screen character.
2 entries
PawPause
Wellness companion that keeps a Petdex pet on screen and nudges you to pause, hydrate, and stay focused.
Evidence “PetDex compatibility: PawPause reads companions installed to ~/.codex/pets.”
FocusPal
Pomodoro companion app for macOS that imports a Petdex pet via /focuspal petdex <slug>.
Evidence “Fetches https://petdex.dev/api/manifest to look up the canonical spritesheet URL.”
Chapter 02
Desktop companions
Apps that put a Petdex pet on your desktop.
17 entries
Hermes Agent
Nous Research's open-source agent renders animated pets in its CLI, TUI, and desktop app, fetching sprites straight from the Petdex gallery.
Evidence “Fetch the public petdex manifest. MANIFEST_URL = "https://petdex.dev/api/manifest" 307-redirects to a JSON document on R2 with spritesheetUrl, petJsonUrl and zipUrl.”
BitFun
Rust-based desktop Agent runtime suite with Petdex companion packages as a first-class type. CSS animations named bitfun-petdex-walk.
Evidence “/// Optional Petdex-compatible companion package selected by the user.”
Skales
Open desktop AI agent whose floating buddy wears Petdex pets as animated skins, with gallery imports and a built-in Petdex sprite creator.
Evidence “The buddy also wears animated pixel pets in the open [Petdex](https://petdex.dev) sprite format - the most-requested feature of the last twenty updates.”
Codux
Native macOS terminal workspace for AI coding tools with a built-in Petdex marketplace for the in-app pet companion.
Evidence “URL(string: petL("pet.custom.market.url", "https://petdex.dev/zh"))”
TermiPet
macOS desktop pet companion for Claude Code and terminal workflows, with Petdex/Codex-compatible pet import, AI status cards, quick commands, and local-first pet chat.
Evidence “TermiPet can import **Petdex / Codex-compatible pet packages**: in Settings -> Pets, choose a pet folder containing `pet.json` and `spritesheet.webp`.”
nom
Shimeji-style desktop pet that eats the AI tokens you burn through Claude Code and Codex CLI. Auto-loads any pet installed via npx petdex install.
Evidence “Skin support: install any petdex pack with npx petdex install <slug>, then right-click 选择宠物 to switch on the fly.”
Prosophor
Plugin-driven proactive agent desktop app that resolves role sprite IDs from bundled Petdex sprite assets.
Evidence “static const char* kPetdexDir = PROSOPHOR_SOURCE_DIR "/assets/petdex-sprites/by-collection";”
Vibe Pet
Seeed Studio's AI coding companion: agent token and task monitoring with Petdex avatars on desktop and ESP32/Wio Terminal hardware.
Evidence “Character switching: choose a character from Petdex by default or use a custom character you made.”
petdex-cc
Desktop pet for Claude Code with 8-level progression, AI speech bubbles, and time-aware greetings. Pulls from 1,569+ Petdex pets.
Evidence “Pick any pet from Petdex (1,569+ community pets). Pets powered by Petdex.”
CodexPet Nest
macOS companion nest overlay with widgets and a Petdex marketplace for browsing and installing community pets.
Evidence “private let manifestURL = URL(string: "https://petdex.dev/api/manifest")!”
PetPhrase
Windows desktop companion: a Petdex pet sits on your desktop, click it to pop a quick-phrase panel and copy snippets in one click.
Evidence “PetPhrase 兼容 petdex 桌宠格式——那个在 X 上火过的 Codex 桌宠生态。”
Agent Critter
Rust Claude Code desktop pet plugin that reacts to agent events and installs sprites directly from the Petdex manifest.
Evidence “ureq::get("https://petdex.dev/api/manifest").call()”
codedog
Physical security gateway and ESP32-S3 desktop mascot for AI coding agents, with Petdex pets displayed from command execution states.
Evidence “Supports direct importing and packaging of pet assets from Petdex & Codex-pets.”
desktop-pet
Tauri v2 desktop pet app with Claude Code hooks, AI chat, and automatic discovery/import of Petdex pet packages from ~/.petdex/pets.
Evidence “**Petdex 生态兼容** — 自动发现 `~/.petdex/pets/` 目录下的宠物包，无需手动��入”
petdex-dock
Tiny Codex pet that lives at the edge of your desktop, installable from the Petdex gallery.
Evidence “Uses the PetDex public gallery for Codex-compatible animated pets. npx petdex install [pet]”
Pets Driven
Windows desktop companion that hatches one pet per project directory and reacts to Claude Code and Codex CLI agent events.
Evidence “Pets installed with this command are stored in `~/.petdex/pets`. Pets Driven automatically discovers this directory and lists its pets during onboarding and pet selection, ready to bind to a working directory.”
PetOS
AI desktop pet agent for Windows and macOS with local memory, proactive companion chat, focus modes, and Petdex import support.
Evidence “内置默认伙伴，也可从 Petdex 或本地文件夹导入。每只宠物有自己的形象、性格与记忆空间。”
Chapter 03
Wearable
Petdex pets running on Apple Watch, Garmin, and other wearables.
2 entries
Codex Pet Watch Sprite
Swift Package + iOS/watchOS demo that renders Petdex pets on Apple Watch complications, with a built-in Petdex gallery picker.
Evidence “iOS デモアプリには Petdex manifest (https://petdex.dev/api/manifest) から一覧を取得し、選択した pet の spritesheetUrl をアプリ内キャッシュへ保存”
garmin-pet
Pipeline that exports Petdex pets to Garmin watch face PNG frames. Wearable adapter for runners.
Evidence “PETDEX_BASE = "https://petdex.dev"”
Chapter 04
SDKs & runtimes
Libraries and runtimes that wrap the Petdex API or pet format for other platforms.
2 entries
OpenPet
Local desktop pet runtime for AI agents (CLI / MCP / HTTP) with Petdex import support.
Evidence “python skills/openpet-cli/scripts/openpet_cli.py import-website https://petdex.dev/pets/boba”
petdex-swift
Community Swift Package that wraps the public Petdex API. iOS example app included.
Evidence “A lightweight Swift Package for the public Petdex API.”
Chapter 05
Bundled in larger apps
Petdex pets shipped as a feature of bigger products.
5 entries
Open Design
Local-first agentic design workspace whose daemon lists Codex/Petdex-style pet packages from ~/.codex/pets and bundled community pets.
Evidence “Lists pets that the upstream `hatch-pet` skill packages under `${CODEX_HOME:-$HOME/.codex}/pets/<id>/` and the curated set bundled with this repo under `assets/community-pets/<id>/`.”
Omniget
Open-source desktop study app (Hotmart, Udemy, PDFs, EPUBs) with a built-in pet mascot system that pulls from Petdex.
Evidence “const MANIFEST_URL: &str = "https://petdex.dev/api/manifest";”
FunHarness Studio
Local AI Agent GUI with a built-in Petdex-powered desktop pet panel for Windows agent workflows.
Evidence “用户可以在左侧导航栏打开宠物面板，从 Petdex 社区精选图鉴中挑选喜欢的像素宠物，也可以上传自定义 Sprite Sheet。”
Codex Pet Platformer
Codex and Claude Code skill that turns any Petdex pet into a customizable side-scrolling platformer deployable to Netlify.
Evidence “PETDEX_MANIFEST_URL = "https://petdex.dev/api/manifest"”
Chapter 06
Pet creators
Solo creators distributing original pets in Petdex package format.
2 entries
Petdex Cute
Original pet pack (Aka Pilot, Homelander) distributed through the Petdex gallery.
Evidence “请访问：https://petdex.dev/pets/aka-pilot”
Petdex Zaizai
Single original pet (Zaizai, a round golden cat) packaged for Petdex submission.
PowerShellZzzslog/Petdex_Zaizai
Evidence “Petdex Zaizai 桌面小宠项目 — distributed as zaizai-petdex.zip”
How to get listed
Ship something with Petdex, then submit
Build with the gallery, API, or pet format, add explicit attribution, and send us the evidence. We review every listing before it ships.