A curated gallery of community-made Codex pets. Browse animations on the website, install with one command, and submit your own pet through GitHub.

• One-command install — no clone, no manual setup, works on macOS / Linux / Windows
• Live gallery — animated previews, filtering, and view/install counters at awesome-codex-pet.pages.dev
• GitHub-native submissions — open an issue or PR, the rest is automated
• Open licensing — code under MIT, pet assets under CC BY-NC 4.0

Each pet is a small shareable package:

pets/<pet-slug>--<author-slug>/
├── submission.json
├── pet.json
└── spritesheet.webp

Preview images are generated into assets/previews/<pet-id>/ as local or CI build output, never inside the pet folder.

No clone required. Pick the script for your shell:

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- firefly--lingxiaotian

# Windows PowerShell
powershell -NoProfile -ExecutionPolicy Bypass -Command "iwr -UseB https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.ps1 | iex; Install-CodexPet firefly--lingxiaotian"

# Anywhere with Node.js
npx awesome-codex-pet firefly--lingxiaotian

List available pets:

curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- --list

Default install locations:

• macOS / Linux: ~/.codex/pets/<pet-id>/
• Windows: %USERPROFILE%\.codex\pets\<pet-id>\

Set CODEX_HOME to override, or AWESOME_CODEX_PET_NO_STATS=1 to opt out of anonymous install counters.

Name	Firefly · by @legeling · Anime Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- firefly--lingxiaotian
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Doro · by @legeling · Anime Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- doro--lingxiaotian
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Frieren · by @legeling · Anime Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- frieren--lingxiaotian
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Mahiro · by @legeling · Anime Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- mahiro--lingxiaotian
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Mikoto · by @legeling · Anime Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- mikoto--lingxiaotian
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Miku · by @legeling · Anime Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- miku--lingxiaotian
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Paimon · by @legeling · Anime Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- paimon--lingxiaotian
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Reimu · by @legeling · Anime Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- reimu--lingxiaotian
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	女弹药Q · by @QunBoo · Anime Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- dnf-female-ammo--qunboo
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Bocchi · by @legeling · Anime Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- bocchi--lingxiaotian
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Aemeath Mini · by @cuNuo · Original Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- aemeath-mini--cunuo
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Apu · by @xchangee · Original Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- apu--xchangee
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Claude · by @xiangking · Original Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- claude--xiangking
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Diaoyi Baobao · by @D1a0y1bb · Original Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- diaoyi-baobao--d1a0y1bb
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Hajimi · by @zeyuwang1999 · Original Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- hajimi--zeyuwang1999
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Hana2 · by @initiatione · Original Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- hana2--initiatione
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Lulu · by @YoGazz · Original Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- lulu--yogazz
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Mika · by @ROTl24 · Original Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- mika--rotl24
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Night Neko · by @netizenXuan · Original Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- night-neko--netizenxuan
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Saki · by @rookie-09 · Original Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- saki--rookie-09
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Shian · by @mistyShen · Original Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- shian-helper--mistyshen
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Wally · by @wally025 · Original Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- wally--wally025
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Xian Xiao Lu · by @qingyunAGI · Original Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- xian-xiao-lu--qingyunagi
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Yi Er · by @gbn666 · Original Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- yier--gbn666
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Yuanzai · by @Gaming33 · Original Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- yuanzai--gaming33
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Yuzubou · by @Keseras34938976 · Original Characters
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- yuzubou--keseras34938976
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Becky · by @NateWanggg · Animals
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- becky--natewanggg
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Bubu · by @gbn666 · Animals
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- bubu--gbn666
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Corgi Companion · by @cxian0928-afk · Animals
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- corgi-companion--cxian0928-afk
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Diandian · by @LLLucasXU · Animals
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- diandian--lllucasxu
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Fleta · by @NateWanggg · Animals
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- fleta--natewanggg
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Frankie · by @AygunVarol · Animals
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- frankie--aygunvarol
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Mai · by @DwDestiny · Animals
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- mai--dwdestiny
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Mimi · by @Spacebody · Animals
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- mimi--spacebody
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Panda · by @Jason-Bai · Animals
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- panda--jason-bai
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Teddy · by @danieloleary · Animals
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- teddy--danieloleary
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	Tian Hua Hua · by @D1a0y1bb · Animals
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- tian-hua-hua--d1a0y1bb
Action	Idle	Waving	Running	Waiting	Review
Preview

Name	CodeNoNo · by @Dqd02 · Robots
Install	curl -fsSL https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- codenono--dq02
Action	Idle	Waving	Running	Waiting	Review
Preview

The fastest path is the submission guide on the website. It walks through categories, the folder layout, and the reviewer checklist.

If you prefer working from the repo:

pets/
└── pet-slug--author-slug/
    ├── submission.json
    ├── pet.json
    └── spritesheet.webp

Use pet-slug--author-slug so multiple authors can ship variants of the same character. Generated previews and README listings are produced by CI:

python -m pip install -r requirements.txt
npm run validate:pr
npm run lint

Contributor PRs should only include submission.json, pet.json, and spritesheet.webp. Maintainers or CI regenerate previews, README listings, and pets.json after merge, but preview binaries are not kept as tracked Git assets.

• .agents/skills/hatch-pet — end-to-end pipeline for designing, generating, QAing, and packaging a pet

• English: docs/en
• 简体中文: docs/zh-CN
• Web gallery source: web/
• Stats worker: worker/
• Contribution guide: CONTRIBUTING.md

• Code and scripts: MIT
• Pet assets and generated previews: CC BY-NC 4.0, unless a pet folder says otherwise