Repolode
Enviar
crafter-station

crafter-station/petdex

Galeria pública e CLI para explorar, instalar e enviar pets animados em pixel art que flutuam na tela e reagem ao Codex e a outros agentes de programação.

Ver no GitHubSite
Estrelas
4,256
Forks
211
Issues abertas
17
Último commit
há 10 dias

O que é?

Petdex é uma galeria comunitária de companheiros animados, chamados pets, criada para o Codex e outros agentes de programação, como Claude Code, Gemini CLI e OpenCode. Cada pet é um pacote pequeno composto por um arquivo de metadados pet.json e uma spritesheet com os quadros da animação. É possível explorar os pets em petdex.dev, instalar um com um único comando npx petdex install e enviar criações próprias.

O projeto tem três partes: uma galeria web em Next.js, uma CLI npm para listar, instalar, enviar e gerenciar coleções, e um app para desktop que mantém o pet ativo flutuando sobre a área de trabalho. O app para desktop anima o pet a cada chamada de ferramenta feita por um agente, e os usuários podem trocar de pet e conectar agentes pelo painel Settings. A API pública de manifest lista todos os pets aprovados, permitindo que outros desenvolvedores criem seus próprios clientes com base nela.

A base de código é um monorepo TypeScript que usa Next.js, React, Drizzle com Postgres, Clerk para autenticação e Cloudflare R2 para armazenamento. O projeto também inclui um ambiente de desenvolvimento local baseado em Docker.

Recursos principais

  • 01Explore e instale pets animados com `npx petdex install <slug>`.
  • 02Envie pets pela linha de comando ou pelo formulário de envio da web.
  • 03App flutuante para desktop que anima o pet a cada chamada de ferramenta de um agente de programação.
  • 04API pública de manifest que lista todos os pets aprovados e as URLs de suas spritesheets.
  • 05Coleções pessoais com uma CLI para listar, criar, editar e excluir.

Casos de uso

  • Dar à sua sessão do Codex ou Claude Code um companheiro visual que reage à atividade do agente.
  • Compartilhar ou baixar mascotes em pixel art para personalizar o desktop.
  • Criar um cliente ou widget personalizado para desktop que obtenha pets da API pública.
  • Criar e publicar seus próprios pets animados em sprites para a comunidade.

Início rápido

  1. 1

    Instale um pet conhecido com a CLI

    npx petdex install boba
  2. 2

    Baixe o aplicativo para desktop em petdex.dev/download

  3. 3

    Abra o aplicativo, pressione Cmd+, sobre o pet, escolha o seu em Pets e conecte os agentes em Agents

Antes de usar

  • O aplicativo para desktop e os pets do Petdex são voltados para o Codex e agentes de programação compatíveis.
  • As artes dos pets são fan art enviada pelos usuários, e os direitos pertencem a quem as enviou, não ao projeto.

Tópicos

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

Perguntas frequentes

O que é petdex?
Galeria pública e CLI para explorar, instalar e enviar pets animados em pixel art que flutuam na tela e reagem ao Codex e a outros agentes de programação. Petdex é uma galeria comunitária de companheiros animados, chamados pets, criada para o Codex e outros agentes de programação, como Claude Code, Gemini CLI e OpenCode. Cada pet é um pacote pequeno composto por um arquivo de metadados pet.json e uma spritesheet com os quadros da animação. É possível explorar os pets em petdex.dev, instalar um com um único comando npx petdex install e enviar criações próprias.
petdex é gratuito? Qual é a licença?
petdex é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
petdex ainda é mantido?
Manutenção ativa. O último commit de petdex foi em 10 de out. de 2026.
Para que posso usar petdex?
Dar à sua sessão do Codex ou Claude Code um companheiro visual que reage à atividade do agente. Compartilhar ou baixar mascotes em pixel art para personalizar o desktop. Criar um cliente ou widget personalizado para desktop que obtenha pets da API pública. Criar e publicar seus próprios pets animados em sprites para a comunidade.
Como instalar petdex?
Instale um pet conhecido com a CLI: npx petdex install boba Baixe o aplicativo para desktop em petdex.dev/download Abra o aplicativo, pressione Cmd+, sobre o pet, escolha o seu em Pets e conecte os agentes em Agents
Onde consigo petdex?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/crafter-station/petdex

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados