Add a Codex pet

Upload a ZIP package yourself, or copy the agent prompt so your agent can list your local custom pets and upload only the one you approve. Publishing now requires Google sign-in.

Agent upload

Let your agent package the right pet

The prompt tells the agent to inspect the local Codex pets folder, exclude built-in OpenAI pets, show you the candidates, and upload only after you approve one and sign in with Google.

Official Codex pets docs

Agent prompt

Upload one of my locally created Codex pets to AgentPets, but do not choose or upload anything without my approval.

Use the official OpenAI Codex pets settings docs as the source of truth:
https://developers.openai.com/codex/app/settings#codex-pets

AgentPets upload endpoint:
https://agentpets.app/api/pets

Uploads require the user's active Google sign-in session on AgentPets.

Do this exactly:
1. Inspect the local Codex custom pets folder: ${CODEX_HOME:-$HOME/.codex}/pets
2. Find only directories that contain both pet.json and spritesheet.webp.
3. Fetch https://agentpets.app/api/manifest and exclude pets that are already public there, especially source="official" OpenAI Codex pets.
4. Do not upload built-in OpenAI pets, pets downloaded from AgentPets, or any folder that is probably not user-created.
5. Show me the candidate list before uploading. For each candidate, include folder name, pet.json id, displayName, description, and last modified time if available.
6. Ask me which pet I want to upload.
7. Only after I explicitly approve one candidate, create a ZIP whose root contains exactly pet.json and spritesheet.webp from that pet folder.
8. If I am not signed in on AgentPets, open https://agentpets.app/upload and ask me to sign in with Google before uploading.
9. Upload the ZIP with multipart form data to https://agentpets.app/api/pets only through an authenticated AgentPets session.
10. If AgentPets returns a validation or auth error, show me the exact error and stop. Do not alter the pet files unless I approve a fix.

Privacy rule: do not send my memory, conversation history, project notes, or private local files to AgentPets.

Google sign-in required

Sign in before uploading

Uploads are public, so each published pet now needs a connected creator account.