Repolode
crafter-station

crafter-station/petdex

화면 위를 떠다니며 Codex 등 코딩 에이전트에 반응하는 픽셀 아트 펫 갤러리와 CLI

스타
4,256
포크
211
열린 이슈
17
마지막 커밋
10일 전

어떤 프로젝트인가요?

Petdex는 Codex와 Claude Code, Gemini CLI, OpenCode 같은 코딩 에이전트를 위해 만든 애니메이션 동반자, 즉 펫을 모아둔 커뮤니티 갤러리입니다. 각 펫은 pet.json 메타데이터 파일과 애니메이션 프레임이 담긴 스프라이트 시트로 구성된 작은 패키지입니다. petdex.dev에서 펫을 둘러보고, `npx petdex install` 명령어 하나로 설치하거나 직접 만든 펫을 제출할 수 있습니다.

프로젝트는 세 부분으로 구성됩니다. Next.js 웹 갤러리, 펫을 조회·설치·제출하고 컬렉션을 관리하는 npm CLI, 그리고 활성화된 펫을 작업 공간 위에 띄우는 데스크톱 앱입니다. 데스크톱 앱은 에이전트가 도구를 호출할 때마다 펫을 움직이며, 사용자는 Settings 패널에서 펫을 바꾸고 에이전트를 연결할 수 있습니다. 공개 manifest API에는 승인된 모든 펫이 등록되어 있어, 다른 개발자도 이를 기반으로 자체 클라이언트를 만들 수 있습니다.

코드베이스는 Next.js, React, Postgres를 사용하는 Drizzle, 인증용 Clerk, 스토리지용 Cloudflare R2를 사용하는 TypeScript 모노레포입니다. Docker 기반 로컬 개발 환경도 포함되어 있습니다.

핵심 기능

  • 01`npx petdex install <slug>` 명령어로 애니메이션 펫을 둘러보고 설치할 수 있습니다.
  • 02CLI 또는 웹 제출 페이지에서 펫을 제출할 수 있습니다.
  • 03코딩 에이전트가 도구를 호출할 때마다 펫을 움직이는 데스크톱 플로터.
  • 04승인된 모든 펫과 스프라이트 시트 URL을 제공하는 공개 manifest API.
  • 05항목 조회, 생성, 수정, 삭제를 지원하는 CLI와 개인 컬렉션.

활용 사례

  • Codex 또는 Claude Code 세션에 에이전트 활동에 반응하는 시각적 동반자를 추가할 수 있습니다.
  • 개인 데스크톱 환경에 사용할 픽셀 아트 마스코트를 공유하거나 다운로드할 수 있습니다.
  • 공개 API에서 펫 정보를 가져오는 맞춤형 데스크톱 클라이언트나 위젯을 만들 수 있습니다.
  • 커뮤니티를 위해 애니메이션 스프라이트 펫을 직접 만들어 공개할 수 있습니다.

빠른 시작

  1. 1

    CLI로 알려진 펫을 설치합니다

    npx petdex install boba
  2. 2

    petdex.dev/download에서 데스크톱 앱을 다운로드합니다

  3. 3

    앱을 열고 펫 위에서 Cmd+,를 누른 다음, Pets에서 펫을 선택하고 Agents에서 에이전트를 연결합니다

사용 전 알아둘 점

  • 데스크톱 앱과 Petdex 펫은 Codex 및 지원되는 코딩 에이전트를 대상으로 합니다.
  • 펫 아트워크는 사용자가 제출한 팬아트이며, 저작권은 프로젝트가 아닌 제출자에게 있습니다.

토픽

자주 묻는 질문

petdex은(는) 무엇인가요?
화면 위를 떠다니며 Codex 등 코딩 에이전트에 반응하는 픽셀 아트 펫 갤러리와 CLI Petdex는 Codex와 Claude Code, Gemini CLI, OpenCode 같은 코딩 에이전트를 위해 만든 애니메이션 동반자, 즉 펫을 모아둔 커뮤니티 갤러리입니다. 각 펫은 pet.json 메타데이터 파일과 애니메이션 프레임이 담긴 스프라이트 시트로 구성된 작은 패키지입니다. petdex.dev에서 펫을 둘러보고, `npx petdex install` 명령어 하나로 설치하거나 직접 만든 펫을 제출할 수 있습니다.
petdex은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
petdex은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
petdex은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. petdex의 마지막 커밋은 2026년 10월 10일입니다.
petdex은(는) 어디에 사용할 수 있나요?
Codex 또는 Claude Code 세션에 에이전트 활동에 반응하는 시각적 동반자를 추가할 수 있습니다. 개인 데스크톱 환경에 사용할 픽셀 아트 마스코트를 공유하거나 다운로드할 수 있습니다. 공개 API에서 펫 정보를 가져오는 맞춤형 데스크톱 클라이언트나 위젯을 만들 수 있습니다. 커뮤니티를 위해 애니메이션 스프라이트 펫을 직접 만들어 공개할 수 있습니다.
petdex는 어떻게 설치하나요?
CLI로 알려진 펫을 설치합니다: npx petdex install boba petdex.dev/download에서 데스크톱 앱을 다운로드합니다 앱을 열고 펫 위에서 Cmd+,를 누른 다음, Pets에서 펫을 선택하고 Agents에서 에이전트를 연결합니다
petdex은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/crafter-station/petdex

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트