Repolode
Submit
crafter-station

crafter-station/petdex

A public gallery and CLI for browsing, installing, and submitting animated pixel-art pets that float on your screen and react to Codex and other coding agents.

View on GitHubWebsite
Stars
4,256
Forks
211
Open issues
17
Last commit
10 days ago

What is it?

Petdex is a community gallery of animated companions, called pets, built for Codex and other coding agents such as Claude Code, Gemini CLI and OpenCode. Each pet is a small package made of a pet.json metadata file and a spritesheet of animation frames. Users can browse pets at petdex.dev, install one with a single npx petdex install command, and submit their own.

The project has three parts: a Next.js web gallery, an npm CLI for listing, installing, submitting and managing collections, and a desktop app that floats the active pet above the workspace. The desktop app animates the pet on each tool call an agent makes, and users switch pets and connect agents from its Settings panel. The public manifest API lists every approved pet, so other developers can build their own clients on top of it.

The codebase is a TypeScript monorepo using Next.js, React, Drizzle with Postgres, Clerk for authentication and Cloudflare R2 for storage. A Docker-based local development setup is included.

Key features

  • 01Browse and install animated pets with `npx petdex install <slug>`.
  • 02Submit pets from the command line or through the web submitter.
  • 03Desktop floater that animates the pet on each coding agent tool call.
  • 04Public manifest API listing all approved pets and their spritesheet URLs.
  • 05Personal collections with a CLI for listing, creating, editing and deleting.

Use cases

  • Giving your Codex or Claude Code session a visual companion that reacts to agent activity.
  • Sharing or downloading pixel-art mascots for personal desktop setups.
  • Building a custom desktop client or widget that reads pets from the public API.
  • Creating and publishing your own animated sprite pets for the community.

Quick start

  1. 1

    Install a known pet with the CLI

    npx petdex install boba
  2. 2

    Download the desktop app from petdex.dev/download

  3. 3

    Open the app, press Cmd+, over the pet, pick your pet under Pets and connect agents under Agents

Things to know

  • The desktop app and Petdex pets are aimed at Codex and supported coding agents.
  • Pet artwork is user-submitted fan art, and rights are held by submitters rather than the project.

Topics

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

FAQ

What is petdex?
A public gallery and CLI for browsing, installing, and submitting animated pixel-art pets that float on your screen and react to Codex and other coding agents. Petdex is a community gallery of animated companions, called pets, built for Codex and other coding agents such as Claude Code, Gemini CLI and OpenCode. Each pet is a small package made of a pet.json metadata file and a spritesheet of animation frames. Users can browse pets at petdex.dev, install one with a single npx petdex install command, and submit their own.
Is petdex free to use? What license does it have?
petdex is open source under the MIT license. Check the license terms before using it in commercial products.
Is petdex still maintained?
Actively maintained. The last commit to petdex was on Oct 10, 2026.
What can I use petdex for?
Giving your Codex or Claude Code session a visual companion that reacts to agent activity. Sharing or downloading pixel-art mascots for personal desktop setups. Building a custom desktop client or widget that reads pets from the public API. Creating and publishing your own animated sprite pets for the community.
How do I install petdex?
Install a known pet with the CLI: npx petdex install boba Download the desktop app from petdex.dev/download Open the app, press Cmd+, over the pet, pick your pet under Pets and connect agents under Agents
Where can I get petdex?
The source code and installation instructions are on GitHub: https://github.com/crafter-station/petdex

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects