Awesome Codex Pets Projects

Awesome Codex Pets

A curated index of projects, tools, libraries, galleries, and experiments for Codex pets and compatible desktop companion workflows.

Featured

• OpenPets.sh - Largest Codex pet registry, with browsing, uploads, installs for Codex-compatible tools, and plugins for live desktop signals. Platform: web, macOS app. License: MIT.
• Codex-Pets.net - Community hub powered by codex-pet-share, a self-hostable app for browsing, sharing, uploading, and installing animated pixel pet packages. Platform: web, TypeScript. License: MIT.

Galleries And Registries

• OpenPets.sh - Largest Codex pet registry, with browsing, uploads, installs for Codex-compatible tools, and plugins for live desktop signals. Platform: web, macOS app. License: MIT.
• Petdex - Public gallery of animated companions for Codex with previews, collections, submissions, and install commands. Platform: web, desktop app. License: unknown.
• Petdex Source - Source repo for the Petdex public gallery, with pet browsing, animation previews, browser validation, submissions, and downloadable packs. Platform: web. License: MIT.
• Codex Pets - Independent community directory for previewing, downloading, installing, and sharing Codex pet packages. Platform: web. License: unknown.
• CodexPets.org - Codex pet browser with package previews, hatch-pet brief builder, install guidance, and URL debugging tools. Platform: web. License: unknown.
• codex-pet-share - Self-hostable web app behind Codex-Pets.net for sharing animated pixel pets, browsing a community gallery, multiplayer playground rooms, and one-line CLI installs. Platform: web, TypeScript, Cloudflare. License: MIT.
• Codex PokéPets - Large themed Codex pet gallery and installer covering 2D and 3D animated Pokémon sprites. Platform: shell, Codex custom pets. License: unknown.

Desktop Companions And Players

• OpenPets - Native macOS desktop pet app with MCP, CLI, assistant setup, release packaging, custom Codex pet support, and shared visible task state. Platform: macOS. License: MIT.
• Clawd on Desk - Cross-platform desktop pet that watches Codex CLI, Claude Code, Cursor, opencode, and other AI coding agents. Platform: macOS, Windows, Linux. License: unknown.
• Petty - Tauri desktop pet player for Codex-compatible pet assets, with built-in pet support and local pet-folder import. Platform: desktop, Tauri. License: unknown.
• Petdex Dock - Electron desktop Codex pet dock that lives at the edge of the desktop. Platform: desktop, Electron. License: unknown.
• Talking Pets - Local Codex pet add-on that monitors assistant speech from local conversation logs and reads it aloud through local TTS. Platform: macOS, Windows, Linux, Node.js, Swift. License: MIT.
• Vibebud - Floating AI buddy for Codex, Claude Code, and other agents, with desktop, web, and Android surfaces for companion presence and notifications. Platform: web, macOS, Windows, Linux, Android. License: MIT.

SDKs And Integrations

• OpenPetsKit - Embeddable Swift runtime for loading bundled pets, hosting desktop pet UI, and sending commands through the shared OpenPets local socket. Platform: macOS, Swift Package Manager. License: MIT.
• agent-pet - Lightweight self-hosted animated companion widget for web apps, delivered as a vanilla DOM/widget library. Platform: web, TypeScript. License: Apache-2.0.
• codex-pet-bridge - Local-first bridge that turns AI agent status into pet-friendly events for desktop pets and XiaoZhi devices. Platform: JavaScript, MCP, webhooks, SSE. License: MIT.

Creation And Validation Tools

• codex-pet-generator-skill - Codex skill for generating compliant animated Codex pet spritesheets and pet.json packages from reference images. Platform: Codex skill, Python. License: unknown.
• OpenAI hatch-pet skill - Curated Codex skill workflow for generating, repairing, validating, previewing, and packaging Codex-compatible animated pets. Platform: Codex skill. License: MIT.

Ambient Status And Experiments

• OpenPets - Shared desktop pet status surface for agent progress, review prompts, completion states, failures, and lightweight animations. Platform: macOS. License: MIT.
• Codex Watch Companion - Proof-of-concept Apple Watch companion and Mac bridge for keeping a Codex pet, task state, and voice-driven chat controls visible from the wrist. Platform: watchOS, macOS, Swift, JavaScript. License: unknown.
• codex-pet-limit-rings - macOS companion overlay that follows the Codex pet and shows short-window and weekly usage-limit rings without patching Codex. Platform: macOS. License: MIT.
• Pet2Dial - Codex skill, round-screen device firmware, and macOS BLE bridge that mirrors the selected Codex pet and task state to M5Stack Dial or LilyGO T-Encoder Pro hardware. Platform: macOS, Codex skill, PlatformIO, BLE hardware. License: MIT.
• TokenPet - Windows desktop pet with a local HTTP proxy for token tracking and Codex/Petdex-format pet imports. Platform: Windows, .NET, WPF. License: MIT.
• TamaCodex - In-Codex pet experiment where a companion grows and evolves from local work signals, token usage, care events, and a macOS sidecar. Platform: macOS. License: MIT.

Contributing

Pull requests are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md) for what belongs here and how to format entries.

License

This list is released under [CC0 1.0 Universal](LICENSE) so the community can copy, remix, and reuse it freely.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: alterhq
• Source: alterhq/awesome-codex-pets-projects
• License: CC0-1.0

Install and usage instructions live in the source repository linked above.