Repolode
Enviar
crafter-station

crafter-station/petdex

Galería pública y CLI para explorar, instalar y enviar mascotas animadas de pixel art que flotan en la pantalla y reaccionan a Codex y otros agentes de programación.

Ver en GitHubSitio web
Estrellas
4,256
Forks
211
Issues abiertos
17
Último commit
hace 10 días

¿Qué es?

Petdex es una galería comunitaria de compañeros animados, llamados mascotas, creada para Codex y otros agentes de programación, como Claude Code, Gemini CLI y OpenCode. Cada mascota es un paquete pequeño compuesto por un archivo de metadatos `pet.json` y una hoja de sprites con los fotogramas de animación. Puedes explorar las mascotas en petdex.dev, instalar una con un único comando `npx petdex install` y enviar las tuyas.

El proyecto tiene tres partes: una galería web Next.js, una CLI de npm para listar, instalar, enviar y gestionar colecciones, y una aplicación de escritorio que muestra la mascota activa flotando sobre el espacio de trabajo. La aplicación de escritorio anima a la mascota cada vez que un agente realiza una llamada a una herramienta, y permite cambiar de mascota y conectar agentes desde el panel Settings. La API pública de manifiestos enumera todas las mascotas aprobadas, para que otros desarrolladores puedan crear sus propios clientes a partir de ella.

El código está organizado como un monorepo de TypeScript que usa Next.js, React, Drizzle con Postgres, Clerk para la autenticación y Cloudflare R2 para el almacenamiento. Incluye un entorno de desarrollo local basado en Docker.

Funciones clave

  • 01Explorar e instalar mascotas animadas con `npx petdex install <slug>`.
  • 02Enviar mascotas desde la línea de comandos o mediante el formulario web.
  • 03Aplicación de escritorio flotante que anima a la mascota cada vez que un agente de programación llama a una herramienta.
  • 04API pública de manifiestos que enumera todas las mascotas aprobadas y las URL de sus hojas de sprites.
  • 05Colecciones personales con una CLI para listar, crear, editar y eliminar.

Casos de uso

  • Dar a tu sesión de Codex o Claude Code un compañero visual que reaccione a la actividad del agente.
  • Compartir o descargar mascotas de pixel art para personalizar el escritorio.
  • Crear un cliente o widget de escritorio personalizado que obtenga las mascotas de la API pública.
  • Crear y publicar tus propias mascotas animadas con sprites para la comunidad.

Inicio rápido

  1. 1

    Instala una mascota conocida con la CLI

    npx petdex install boba
  2. 2

    Descarga la aplicación de escritorio desde petdex.dev/download

  3. 3

    Abre la aplicación, pulsa Cmd+, sobre la mascota, elige la tuya en Pets y conecta los agentes en Agents

Antes de usarlo

  • La aplicación de escritorio y las mascotas de Petdex están pensadas para Codex y los agentes de programación compatibles.
  • Las ilustraciones de las mascotas son fan art enviado por los usuarios, y los derechos pertenecen a quienes lo envían, no al proyecto.

Temas

#ai-agents#pixel-art#sprites#cli#desktop-app#nextjs#typescript#developer-tools#claude-code#clerk

Preguntas frecuentes

¿Qué es petdex?
Galería pública y CLI para explorar, instalar y enviar mascotas animadas de pixel art que flotan en la pantalla y reaccionan a Codex y otros agentes de programación. Petdex es una galería comunitaria de compañeros animados, llamados mascotas, creada para Codex y otros agentes de programación, como Claude Code, Gemini CLI y OpenCode. Cada mascota es un paquete pequeño compuesto por un archivo de metadatos `pet.json` y una hoja de sprites con los fotogramas de animación. Puedes explorar las mascotas en petdex.dev, instalar una con un único comando `npx petdex install` y enviar las tuyas.
¿petdex es gratuito? ¿Qué licencia tiene?
petdex es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿petdex sigue mantenido?
Mantenimiento activo. El último commit de petdex fue el 10 oct 2026.
¿Para qué puedo usar petdex?
Dar a tu sesión de Codex o Claude Code un compañero visual que reaccione a la actividad del agente. Compartir o descargar mascotas de pixel art para personalizar el escritorio. Crear un cliente o widget de escritorio personalizado que obtenga las mascotas de la API pública. Crear y publicar tus propias mascotas animadas con sprites para la comunidad.
¿Cómo se instala petdex?
Instala una mascota conocida con la CLI: npx petdex install boba Descarga la aplicación de escritorio desde petdex.dev/download Abre la aplicación, pulsa Cmd+, sobre la mascota, elige la tuya en Pets y conecta los agentes en Agents
¿Dónde consigo petdex?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/crafter-station/petdex

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados