Instalar y activar

Lleva una mascota a Codex

Elige una mascota, instálala con el método de tu sistema y actívala en los ajustes de Codex.

Elegir una mascota Instalar con ChatGPT

La ruta más corta

Cada página de mascota prepara su identificador y método de instalación.

1. Elige una mascota
Abre su página y revisa todas las animaciones.
2. Elige un método
Usa ChatGPT, Bash, PowerShell o el instalador local.
3. Actívala
Reinicia Codex y selecciónala en Ajustes → Mascotas.

Elige el método para tu sistema

El instalador solo descarga pet.json y spritesheet.webp, verifica el manifiesto y SHA-256, y activa el paquete de forma atómica.

macOS / Linux

Requiere curl y bash.

curl -fsSL --proto '=https' --tlsv1.2 https://raw.githubusercontent.com/legeling/awesome-codex-pet/main/scripts/install-pet.sh | bash -s -- --raw-base https://raw.githubusercontent.com/legeling/awesome-codex-pet/main <pet-slug--author-slug>

Confirm the pet id

Use the complete pet-slug--author-slug value. The author suffix lets different versions of the same character coexist.

Run as your own user

No sudo or administrator shell is needed. A custom CODEX_HOME is supported when your setup uses another location.

Verify the two runtime files

Tras la instalación, pets/<pet-id>/ solo contiene pet.json y spritesheet.webp; también se comprueban SHA-256 y la cabecera WebP antes de activarlo.

Enable the pet in Codex

Installation places the files; Codex still needs to load and select the pet.

1
Restart Codex
If Codex was open during installation, quit and reopen it so the custom pet catalog refreshes.
2
Open Settings → Pets
Find the custom-pet section and confirm that the new id appears without an error badge.
3
Select the pet
Activate it, return to your workspace, and check idle, work, review, and movement states.

V1 and V2 install the same way

V1 pets contain nine standard action rows. V2 keeps those actions and adds 16 look directions. The atlas size and spriteVersionNumber differ, but the installer and destination do not.

Manage an installation

Default location: Pets are stored in ~/.codex/pets/<pet-id>/ on macOS and Linux, or %USERPROFILE%\.codex\pets\<pet-id> on Windows.
Custom Codex home: Set CODEX_HOME before the command, or pass --codex-home to the Bash and local Node.js installers.
Update or reinstall: Para reinstalar el mismo ID usa --force (o -Force en PowerShell). La sustitución es atómica y no toca otras mascotas.
Uninstall: Quit Codex, remove only that pet's folder, then reopen Codex. No registry or system files are created.
Anonymous install count: Successful scripts send one anonymous install event. Set AWESOME_CODEX_PET_NO_STATS=1 to disable it.

FAQ

Abrir galería →

Where are pets installed?

Each pet lands in your Codex home (default ~/.codex) under pets/<pet-id>/.

Can I uninstall a pet?

Delete the pet folder. Nothing else is touched.

Is sudo required?

No. Installs are scoped to your user directory.

The pet does not appear after installation. What should I check?

Confirm both runtime files exist, verify that pet.json.id matches the folder name, restart Codex, then look under Settings → Pets again.

Can V1 and V2 pets coexist?

Sí. Las mascotas V1 y V2 con IDs distintos pueden convivir; --force solo reemplaza la carpeta del ID indicado.