About
An open-source gallery of 216+ animated companions for Codex. Install one with a single command and ship with company.
AgentPets is a public, open-source registry. Every entry is a pet pack: a tiny bundle of metadata and pixel art that Codex knows how to display while you work. Think of it as a Pokédex for app companions.
The platform takes the guesswork out: there's a CLI for installing and submitting, a tagged gallery so finding the right companion doesn't require scrolling, and per-vibe collections like cozy pets or focused pets.
Each pet is two files. pet.json defines the metadata (name, the 9 animation states, frame durations) and spritesheet.webp holds the pixel art as a horizontal strip. Codex loads them at startup and swaps states based on what's happening in your session.
Independent product
AgentPets keeps compatibility with the open pet package format and may read Petdex-compatible gallery data while building its own domain, CLI, creator flow, curated collections, and multi-agent runtime support. Pet assets remain owned by their submitters and underlying IP holders.
A Codex pet is a small animated pixel companion for the app. Each pet ships as a single pet.json describing 9 states (idle, working, sleeping, etc.) plus a horizontal spritesheet. Codex picks the right state automatically based on what you're doing in your session.
From the gallery page or any pet detail page, copy the install command (looks like `npx -y https://github.com/agiagentsdev/agentpets-dev/releases/latest/download/agentpets-cli.tgz install boba`) and paste it into your terminal. The CLI fetches the pet from R2, drops it under ~/.codex/pets/<slug>/, and tells Codex to use it. Works on macOS, Linux, and Windows (via PowerShell).
Most pets are submitted by the community through the website or the AgentPets CLI. A handful are featured curated entries that seed the gallery. Every pet is reviewed by an admin before it goes live.
Yes. Sign in with the agentpets CLI (npx -y https://github.com/agiagentsdev/agentpets-dev/releases/latest/download/agentpets-cli.tgz login) and run `npx -y https://github.com/agiagentsdev/agentpets-dev/releases/latest/download/agentpets-cli.tgz submit ./my-pet/`. The CLI uploads the assets to R2 and queues the submission for review. You can also submit through the website at /submit. All you need is a pet.json file and a 9-state spritesheet.
Every pet on AgentPets is free to install and use. Pets keep credit to their original authors. The AgentPets platform itself (CLI + site) is open source.
Each pet is tagged with a kind (creature, object, character) and one to three vibes (cozy, playful, focused, mystical, …). These power the gallery filters and the per-vibe / per-kind landing pages so you can find a companion that matches your mood without scrolling 70+ entries.
AgentPets is built as a developer community product. Storage and database costs are handled by the platform, and product analytics stay focused on install and gallery usage.