Repolode
crafter-station

crafter-station/petdex

Публичная галерея и CLI для просмотра, установки и публикации анимированных пиксельных питомцев, которые плавают поверх рабочего стола и реагируют на Codex и другие coding agents.

Звёзды
4,256
Форки
211
Открытые issues
17
Последний коммит
10 дней назад

Что это?

Petdex — это сообщественная галерея анимированных компаньонов, или питомцев, созданных для Codex и других coding agents, таких как Claude Code, Gemini CLI и OpenCode. Каждый питомец — небольшой пакет, состоящий из файла метаданных pet.json и спрайт-листа с кадрами анимации. Питомцев можно просматривать на petdex.dev, устанавливать одной командой `npx petdex install` и публиковать собственных.

Проект состоит из трёх частей: веб-галереи на Next.js, npm CLI для просмотра, установки и публикации питомцев, а также управления коллекциями, и настольного приложения, которое отображает активного питомца поверх рабочего пространства. Приложение анимирует питомца при каждом вызове инструмента агентом, а переключать питомцев и подключать агентов можно в панели Settings. Публичный manifest API содержит список всех одобренных питомцев, поэтому другие разработчики могут создавать на его основе собственные клиенты.

Кодовая база — монорепозиторий на TypeScript с Next.js, React, Drizzle и Postgres, Clerk для аутентификации и Cloudflare R2 для хранения данных. Для локальной разработки предусмотрена среда на основе Docker.

Ключевые возможности

  • 01Просмотр и установка анимированных питомцев командой `npx petdex install <slug>`.
  • 02Публикация питомцев из командной строки или через веб-форму.
  • 03Настольное приложение, которое анимирует питомца при каждом вызове инструмента coding agent.
  • 04Публичный manifest API со списком одобренных питомцев и URL их спрайт-листов.
  • 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?
Публичная галерея и CLI для просмотра, установки и публикации анимированных пиксельных питомцев, которые плавают поверх рабочего стола и реагируют на Codex и другие coding agents. Petdex — это сообщественная галерея анимированных компаньонов, или питомцев, созданных для Codex и других coding agents, таких как Claude Code, Gemini CLI и OpenCode. Каждый питомец — небольшой пакет, состоящий из файла метаданных pet.json и спрайт-листа с кадрами анимации. Питомцев можно просматривать на petdex.dev, устанавливать одной командой `npx petdex install` и публиковать собственных.
petdex можно использовать бесплатно? Какая у него лицензия?
petdex распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
petdex всё ещё поддерживается?
Активно поддерживается. Последний коммит в petdex — 10 окт. 2026 г..
Для чего можно использовать 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 проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты