Awesome Codex Pet CLI
A free gallery of animated pets for Codex: one npx command installs your pick into the Codex folder and verifies SHA-256 hashes.
- 1,279 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The tool downloads files from the network and writes them to `~/.codex/pets`; the manifest and SHA-256 hashes are verified.
- Anonymous install counters are sent unless disabled.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/awesome-codex-petDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The tool downloads files from the network and writes them to `~/.codex/pets`; the manifest and SHA-256 hashes are verified.
- Anonymous install counters are sent unless disabled.
This is third-party code. Review the repository files before installing.
What it does
Awesome Codex Pet is the source catalog behind codexpet.top, a community collection of pets for Codex. Each pet is a small package of `submission.json`, `pet.json` and `spritesheet.webp`. The `@legeling/codex-pet` command-line tool lists, searches and downloads packages without cloning the repository. The installer checks the manifest and SHA-256 hashes, stages files in a temporary folder first and replaces an installed package only with `--force`. The repository ships three skills: `submit-codex-pet` to request or submit a pet, `hatch-pet-v1` and `hatch-pet-v2` to build pets in the legacy 8x9 and new 8x11 formats with 16 look directions.
Who it is for. Codex users who want a pet in the interface and creators ready to make their own character.
Good fit when
- You want to pick a pet from the catalog and install it with one command.
- You need to list or search packages in the terminal.
- A creator wants to make a custom pet with the `hatch-pet-v2` skill.
- An old v1 pet must be upgraded to v2 with look directions.
- The character is missing and a request to the community makes sense.
Not a fit when
- Pets are for a commercial product: assets are released under CC BY-NC 4.0.
- You need a functional coding tool rather than interface decoration.
- Node.js 20 or newer is missing and you do not want to install it.
Example request
List the Codex pets and install `firefly--lingxiaotian`.Limitations
Node.js 20 or newer is required: it runs the `npx` utility and no clone is needed. Code is MIT while pet artwork is CC BY-NC 4.0, so non-commercial use only. The installer sends anonymous install counters, which `AWESOME_CODEX_PET_NO_STATS=1` turns off. A character request carries no delivery guarantee: a volunteer draws it and no deadline is promised. Pets are decoration and do not change how the agent works. For reproducible installs pin the npm package version and a commit through `--raw-base`.
How to disable. Delete the pet folder at `~/.codex/pets/<pet-id>/` (on Windows `%USERPROFILE%\.codex\pets\<pet-id>\`) or turn it off in Codex settings.
FAQ
Where is a pet installed?
Into `~/.codex/pets/<pet-id>/` on macOS and Linux and `%USERPROFILE%\.codex\pets\<pet-id>\` on Windows. Override the root with `CODEX_HOME`.
Do I need to clone the repository?
No. The `npx` command downloads the package from the catalog; a clone is only for working on sources.
How do v1 and v2 differ?
v1 uses a 1536x1872 atlas with 8 columns by 9 rows. v2 has 11 rows at 1536x2288 and adds 16 look directions.
How do I replace an installed pet?
Repeat the install with `--force`; without it the tool does not replace an existing package.
How do I submit my own pet?
Through the `submit-codex-pet` skill or a normal PR with three files: `submission.json`, `pet.json`, `spritesheet.webp`.
Discussion
No questions or reviews yet.
Related
CLI toolsA Codex skill that builds an animated companion from two or more of your photos and generates it on your own machine
Two skills for Codex and Claude Code draw fan illustrations and comics of Whale-chan with her look kept consistent
Skill, MCP server and CLI that let any agent call Codex image generation, after picking a style from several directions
A Codex plugin connects Tavotto tools to edit matplotlib figures, arrange panels and check publication settings before export.
A skill that turns one photo into a Heytea-inspired doodle poster, a flavor monster character or a runnable desktop pet.
Fifty-one Codex skills that turn a photo into a poster, avatar, comic or illustration in a chosen visual style.
README in short
The catalog is built from packages with creator attribution and collections. Previews and README listings are generated in CI, so contributors submit only three files.