Community submissions

Submit a Codex pet

Pets Codex lists community-made desktop companions. Upload a zip from your account for admin review, or add the pet to the GitHub catalog with a pull request.

Upload a pet Open GitHub repo Browse pets
Pets Codex mascot

Request a pet or send feedback

Need another Codex pet resource, an anime character, an animal companion, or a better catalog detail? Send a quick note here and it will appear in the admin panel.

To keep requests readable, one IP can submit up to 5 notes per day.
1

Upload a zip

Sign in, choose a package under 5MB, and preview pet.json plus spritesheet.webp before submitting.

2

Wait for review

After approval, the pet gets a public page at /pets/your-slug and can be downloaded from the website.

3

Or use GitHub

For CLI support, add the pet to the GitHub repository catalog and open a pull request for review.

Minimal pet.json example

Keep names and descriptions in English so the catalog is friendly for global Codex users.

{
  "displayName": "Sleepy Cat",
  "description": "A cozy sleepy cat Codex pet with soft idle animations.",
  "spritesheetPath": "spritesheet.webp"
}