Acerca de

Petdex es el índice de mascotas de Codex

Una galería open source de más de 0 compañeros animados para Codex. Instala uno con un solo comando y programa con compañía.

Qué es Petdex

Petdex es un registro público y open source. Cada entrada es un paquete de mascota: un pequeño bundle de metadata y pixel art que Codex sabe mostrar mientras trabajas. Piénsalo como una Pokédex de compañeros para la app.

La plataforma te ahorra las dudas: hay un CLI para instalar y enviar, una galería con etiquetas para encontrar el compañero correcto sin scrollear sin fin y colecciones por vibra como mascotas acogedoras o mascotas enfocadas.

Cómo funciona un paquete de mascota

Cada mascota son dos archivos. pet.json define la metadata — nombre, los 9 estados de animación, duraciones de frames — y spritesheet.webp guarda el pixel art en una tira horizontal. Codex los carga al iniciar y cambia de estado según lo que esté pasando en tu sesión.

FAQ

¿Qué es una mascota de Codex?

Una mascota de Codex es un pequeño compañero animado en pixel art para la app. Cada mascota viene como un solo pet.json que describe 9 estados (idle, working, sleeping, etc.) más un spritesheet horizontal. Codex elige el estado correcto automáticamente según lo que estés haciendo en tu sesión.

¿Cómo instalo una mascota?

Desde la galería o cualquier página de detalle, copia el comando de instalación (se ve como `npx petdex install boba`) y pégalo en tu terminal. El CLI trae la mascota desde R2, la deja en ~/.codex/pets/<slug>/ y le dice a Codex que la use. Funciona en macOS, Linux y Windows (vía PowerShell).

¿De dónde salen las mascotas?

La mayoría las envía la comunidad desde la web o el CLI de petdex. Unas cuantas son entradas curadas y destacadas seleccionadas por Crafter Station. Cada mascota pasa por revisión de un admin antes de aparecer en la galería.

¿Puedo enviar mi propia mascota?

Sí. Inicia sesión con el CLI de petdex (`npx petdex login`) y corre `npx petdex submit ./my-pet/`: el CLI sube los assets a R2 y deja el envío en cola para revisión. También puedes enviarla desde la web en /submit. Solo necesitas un archivo pet.json y un spritesheet de 9 estados.

¿Las mascotas de Petdex son gratis y open source?

Cada mascota de Petdex es gratis para instalar y usar. Las mascotas conservan el crédito de sus autores originales. La plataforma Petdex en sí (CLI + sitio) es open source bajo el paraguas de Crafter Station.

¿Qué es una vibe? ¿Qué es un kind?

Cada mascota se etiqueta con un kind (creature, object, character) y entre una y tres vibes (cozy, playful, focused, mystical, …). Eso alimenta los filtros de la galería y las landing pages por vibe o kind para que encuentres un compañero que encaje con tu mood sin revisar más de 70 entradas.

¿Cómo gana dinero Petdex?

No gana. Petdex es un proyecto comunitario gestionado por Crafter Station. El equipo de plataforma absorbe el storage y la base de datos: sin anuncios, sin upsells y sin telemetría más allá de la analítica estándar sobre qué mascotas se instalan.