petdex

Name: petdex
Author: crafter-station

Verified

The public gallery of animated pet for Codex, Claude Code, OpenCode y Gemini CLI

3,308stars

130forks

TypeScript

Installation

# Add to your Claude Code skills
git clone https://github.com/crafter-station/petdex

Getting Started

Guides for using cli tools skills like petdex.

Getting Started with AI Skills
First-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
SkillsLLM Features Guide
Voting, bookmarks, comments, comparison pages, and security scanning explained.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.

Security ReportVerified

Last scanned: 6/7/2026

{
  "issues": [
    {
      "type": "npm-audit",
      "message": "@clerk/nextjs: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@esbuild-kit/core-utils: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@esbuild-kit/esm-loader: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/core: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@jimp/custom: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "@vibrant/image-node: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "drizzle-kit: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "esbuild: esbuild enables any website to send any requests to the development server and read the response",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "file-type: file-type affected by infinite loop in ASF parser on malformed input with zero-size sub-header",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "next: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "next-intl: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "node-vibrant: Vulnerability found",
      "severity": "medium"
    },
    {
      "type": "npm-audit",
      "message": "postcss: PostCSS has XSS via Unescaped </style> in its CSS Stringify Output",
      "severity": "medium"
    }
  ],
  "status": "PASSED",
  "scannedAt": "2026-06-07T07:56:15.624Z",
  "npmAuditRan": true,
  "pipAuditRan": true
}

README.md

Frequently Asked Questions

What is petdex?

petdex is an open-source cli tools skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by crafter-station. The public gallery of animated pet for Codex, Claude Code, OpenCode y Gemini CLI. It has 3,308 GitHub stars.

Is petdex safe to use?

Yes. petdex passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install petdex?

Clone the repository with "git clone https://github.com/crafter-station/petdex" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is petdex written in?

petdex is primarily written in TypeScript. It is open-source under crafter-station on GitHub, so you can review or fork the full source.

Are there alternatives to petdex?

Yes. SkillsLLM lists many other CLI Tools skills you can browse and compare side by side. Open the CLI Tools category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh petdex against similar tools.

LLM Engineer for Beginners

Ship LLM features to production - prompts, RAG, structured outputs, evaluation

39 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

228,677

Popular in CLI Tools

Top skills in this category by stars

ui-ux-pro-max-skill

by nextlevelbuilder

An AI SKILL that provide design intelligence for building professional UI/UX multiple platforms

104,444

antigravity-claude-proxy vibeproxy

What is Petdex

Petdex is three things working together:

A web gallery at petdex.dev where the community submits, reviews, and showcases animated pets in the Codex sprite format.
A CLI that installs any pet on your machine with one command and ships them straight into Codex.
A desktop app that floats a pet on your screen and reacts to your coding agent's activity in real time.

Every pet is a folder. Every folder is a Pokédex entry. Every entry is one npx petdex install away.

Quick start

Follow this checklist to get a pet installed, visible in Codex, and connected to the desktop app.

Install a known pet:

npx petdex install boba

You should see ~/.codex/pets/boba/ with pet.json and a spritesheet.

Initialize Petdex Desktop and agent hooks:

npx petdex init

This downloads the desktop app, starts it, and wires supported agents for /petdex.

Open Codex, go to Settings → Appearance → Pets, choose Boba, and click Select. Use /pet inside Codex to wake the pet or tuck it away.
Verify the setup:

npx petdex doctor

If hooks are installed, you can also type /petdex status inside a supported agent.

For users

You want to...	Do this
Browse pets	Visit petdex.dev
Install a pet	`npx petdex install <slug>`
Switch active mascot	`npx petdex select` (interactive picker) or `npx petdex select <slug>`
Run the desktop floater	`npx petdex init` (downloads the `.dmg` and wires Codex/Claude Code hooks)
Make a pet	Use the `hatch-pet` skill inside Codex, or build one with the Petdex creator tools
Submit a pet	`npx petdex submit ./my-pet/` or drop it through the web submitter
Join the community	Discord

Full CLI reference: packages/petdex-cli/README.md.

For builders

If you want to build on top of Petdex (a desktop client, a wearable, an SDK, a Discord bot, anything), you have two stable surfaces:

The HTTP API. petdex.dev/api/manifest returns every approved pet with its slug, spritesheet URL, animation states, and metadata.
The pet package format. Every pet is a pet.json plus a spritesheet.{webp,png} rendered as an 8×9 grid of 192×208 frames.

21 open-source and source-available projects already build on these. See petdex.dev/built-with for the catalog, then submit yours via the issue template.

Architecture

crafter-station/petdex
├── src/
│   ├── app/[locale]/          Public site: gallery, /pets/<slug>, /collections, /built-with, /community, /create, /download, /submit, /u/<handle>, ...
│   ├── app/api/cli/           CLI endpoints: OAuth config, submit (zip → presigned R2), dedup check, register
│   ├── app/api/manifest/      Public manifest: every approved pet with its spritesheet URL
│   ├── app/api/admin/         Admin review surface for submissions, edits, collection requests
│   └── lib/db/schema.ts       Drizzle schema (Postgres)
├── packages/
│   ├── petdex-cli/            npm `petdex` (auth, list, install, select, submit, hooks, init)
│   ├── petdex-desktop/        Zig + WebKit floating mascot for macOS
│   └── discord-bot/           Discord.js bot for the Petdex server
├── public/built-with/         Screenshots for the community page
├── public/brand/              Logos, OS icons, Discord icon
└── drizzle/                   SQL migrations (Postgres schema history)

Web stack: Next.js 16, React 19, Tailwind, Drizzle, Postgres, Redis, Clerk, R2. CLI: Bun + TypeScript, ships as a single npm binary. Auth via Clerk OAuth + PKCE. Desktop: Zig on a fork of vercel-labs/zero-native, HTTP sidecar in Node for agent hooks.

Develop locally

Two paths are supported.

Goal	Command	Setup
Local full stack	`bun run dev:docker`	Docker or Podman, ~30s warm-up.
Run against real services	`bun run dev`	`.env.local` filled (maintainers only).

git clone https://github.com/crafter-station/petdex.git
cd petdex
bun install
bun run dev:docker

Open localhost:3000. Full guide in CONTRIBUTING.md.

Pet package format

Every pet is two files:

my-pet/
├── pet.json                Metadata: name, slug, tags, vibes, kind, frame size, animation states
└── spritesheet.webp        8 rows × 9 cols = 72 frames of 192×208 px each (or .png)

Animation states are the rows: idle, wave, run, failed, review, jump, extra1, extra2. Codex maps these to its agent activity hooks. Loop timing defaults to 1100ms at 6 frames per state.

Contribute

Submit a pet: petdex.dev/submit or npx petdex submit <path>.
List your project: open a Built with Petdex issue.
Fix a bug or add a feature: read CONTRIBUTING.md, then open a PR.
Hang out: Discord has channels for shipping (#wip, #ship-or-sink), feedback (#cli-feedback), and showcases (#showcase).

Pet IP and takedowns

Pets are user-submitted fan art. Petdex does not claim rights to any underlying IP. If you hold rights to a character and want a pet removed, file a takedown request and we review within 48 hours.

License

The source code is MIT. Pet assets are owned by their submitters under whatever license they choose to declare.

Made by Crafter Station. Lead: @RaillyHugo.