Browse and install pixel art pets with the Petdex CLI, a command line tool. Submit your own artwork with a chosen license, or update descriptions and sprite images for pets you own.
Browse, install, submit, and edit pixel-art pets with the Petdex CLI. Use when a user asks for a coding companion, wants to install a Petdex pet, or wants to publish or update artwork they own.
Review the instructions the agent will receive before you install.
Use the published petdex CLI for the catalog. Node.js 20 or later is required.
Read the current command help before using unfamiliar flags:
bunx petdex --help
bunx petdex --version
If Bun is unavailable, use npx -y petdex for the same commands.
bunx petdex list
bunx petdex install boba
bunx petdex install boba mochi
Choose a slug from the catalog. Installation writes the pet to both ~/.petdex/pets/<slug>/ and ~/.codex/pets/<slug>/. Report the installed slugs and any command failure.
Publish only artwork the user has asked to submit, with the license they selected. If the license is missing, ask rather than choosing the rights for them.
bunx petdex login
bunx petdex whoami
bunx petdex submit ./my-pet --license cc-by
Login opens a browser and stores credentials locally. A headless session needs an existing login; never ask the user to paste tokens.
The example uses CC BY. Supported license IDs are cc0, cc-by, cc-by-sa, cc-by-nc, and all-rights-reserved. Each pet folder needs pet.json and spritesheet.webp or spritesheet.png. The sheet must use the supported 8-by-9 or 8-by-11 atlas layout. A ZIP or a parent directory containing multiple pets is also accepted.
Let duplicate detection run normally. Use --force only when the user wants duplicate submissions. Report the submission result; submission is not approval or publication in the gallery.
bunx petdex edit boba --desc "A tiny otter sipping bubble tea"
bunx petdex edit boba --sprite ./spritesheet.webp
Send only the requested changes. The CLI also accepts --displayName, --meta, and --zip.
The floating companion is Petdex Desktop, available at https://petdex.dev/download. Its Settings window selects the pet and installs agent hooks. The catalog CLI does not start the desktop app or manage those hooks. Retired commands such as init, up, doctor, select, and hooks install are not the setup flow.
For authentication trouble, run whoami and follow the CLI error. For unsupported commands or flags, use --help. Do not treat a nonzero exit as success.
No reviews yet. Tell others what you thought.
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
Review code changes for bugs, security risks, design issues, and test quality, then turn findings into specific, prioritized feedback. Use its checklists and comment templates to establish consistent review standards and support developer mentoring.
Build React interfaces with coss components using documented imports, properties, and composition patterns. It helps select components, implement forms and overlays, preserve accessibility, and address migration mistakes when moving from shadcn/Radix to coss/Base UI.
Find reusable interface examples built with coss UI components. Match forms, dialogs, calendars, and other interface needs to indexed patterns, retrieve their source code through JSON links, and adapt the code for your project.