Maew the Codogotchi bursting out of a cracked egg in a shower of golden sparkles

Hatch a pet — no pixel-art skills required.

hatch-codogotchi is a plugin for the Codex desktop app that generates a complete, animated Codogotchi from a text description, an existing Codex pet, or a seed image. Codex renders every frame with its built-in image generation, one row at a time, self-validates each strip, writes pet.json, and installs it for you.

Codex-only for now — the plugin relies on Codex's built-in image_gen tool, which other coding agents don't have.

Install the plugin

The plugin and its skills live in the repo at plugins/hatch-codogotchi. In the Codex desktop app, just paste:


Install the hatch-codogotchi plugin and its
        associated skills from
https://github.com/cesarnml/codogotchi/tree/main/plugins/hatch-codogotchi

chat

Text description

e.g. "a chibi orange tabby in a tiny yellow hoodie, round head, warm pastel palette." The character is designed during the run.

pets

Existing Codex pet

Already have a native Codex pet in ~/.codex/pets? Codex extracts a reference frame from its spritesheet and stays on-model.

image

Seed image

Drop a single 192×208 character image. Most consistent results — Codex extracts a reference and animates it across every state.

How it works

Install the plugin

Point Codex at the plugin in the repo and ask it to install hatch-codogotchi and its skills.

Give a starting point

A text description, an existing Codex pet from ~/.codex/pets, or a seed image.

Codex generates rows

Frames are drawn one row at a time with image_gen and self-validated.

Restart Codogotchi

It installs to ~/.codogotchi/pets/<id>/. Your pet is alive.

Three ways to hatch — just ask Codex

chat From a text description

Use the hatch-codogotchi-codex-and-lite-basic skill.
Hatch a new Codogotchi named "Mochi" from this description: a chibi orange tabby in a tiny yellow hoodie, round head, warm pastel palette. Plush style.

pets From an existing Codex pet

Use the hatch-codogotchi-lite-basic skill.
Hatch a Codogotchi from my existing Codex pet in ~/.codex/pets/<pet-name>.

image From a seed image

Use the hatch-codogotchi-codex-and-lite-basic skill.
Hatch a new Codogotchi named "Mochi" from this seed image.

construction The five skills

Skill	Starting point	Produces
`hatch-codogotchi-codex-and-lite-basic`	Description or seed image	Codex + Lite-Basic
`hatch-codogotchi-codex-and-lite-full`	Description or seed image	Codex + Lite-Basic + Lite-Enhanced
`hatch-codogotchi-lite-basic`	Existing Codex spritesheet	Lite-Basic
`hatch-codogotchi-lite-enhanced`	Codex + Lite-Basic	Lite-Enhanced
`hatch-codogotchi-soa`	Existing Codex spritesheet	Son-of-Anton delivery gates

inventory_2 What you get

image spritesheet.webp · Tier 1 Codex 8×9 settings codogotchi-lite-basic-spritesheet.webp · Tier 2 Lite-Basic 8×9 auto_awesome codogotchi-lite-enhanced-spritesheet.webp · Tier 3 Lite-Enhanced 8×8 star codogotchi-soa-spritesheet.webp · Tier 4 SoA 8×10 description pet.json

Start with Tier 1 + Tier 2 (Lite-Basic) — the gallery minimum bar. Add Tier 3 (Lite-Enhanced) for polish states like cramming, editing, and web-search. Tier 4 (SoA) is independent — hatch it anytime to light up delivery gates from Son-of-Anton, a structured delivery orchestrator.

menu_book Prefer to draw it yourself? Spritesheet Reference arrow_forward photo_library Browse the Gallery arrow_forward