Skip to content

FROM DOWNLOAD TO DESKTOP

A home in your favorite tools.

Codex is the only native pet host. Agent Pets, Petdex, and Clawd on Desk are separate desktop renderers; Claude Code, Gemini CLI, OpenCode, Copilot CLI, and Cursor connect through local hooks or plugins.

Generated orders use the compatible v1 8×9 atlas. Catalog v2 entries use the marked 8×11 atlas and expose Petdex and Clawd packages; Codex Desktop/CLI, Agent Pets, and coding-tool bridges remain v1-only. Install the destination application separately. Claude Desktop chat is a separate product; the listed Claude integration is Claude Code only.

CodexNative pet
  1. Download and extract the ZIP into a folder named after your pet.
  2. Place that folder inside ~/.codex/pets/ (or $CODEX_HOME/pets/ if configured). Keep pet.json and the included spritesheet.png or spritesheet.webp directly inside the pet folder, not another nested folder.
  3. Desktop: open Settings → Pets, select Refresh, choose your pet, and enter /pet. Codex CLI: enter /pets. Terminal pets require iTerm2 3.6+, Kitty graphics, or Sixel support, and do not work inside tmux or Zellij.
Read the Codex pet documentation ↗
Claude CodeHooks/plugin bridge
  1. Download the Claude Code ZIP, not the Codex ZIP.
  2. Install the Pet Studio installer first. npm install --global @pet-studio/pets@0.2.0
  3. Rename your download to my-pet.zip, then run:
pets install ./my-pet.zip --target claude-code
pets doctor <pet-id> --target claude-code
pets launch <pet-id> --target claude-code

Replace <pet-id> with the ID in your package’s pet.json.

Installation adds managed hooks or a local event plugin. Launch starts the separate Agent Pets renderer and may download it on first use. Restart your coding tool after installation. It reports activity states, not your prompts or code.

Check the included README for target-specific requirements. If the pet does not appear, run the doctor command before reinstalling.

Read the Claude Code upstream docs ↗
Gemini CLIHooks/plugin bridge
  1. Download the Gemini CLI ZIP, not the Codex ZIP.
  2. Install the Pet Studio installer first. npm install --global @pet-studio/pets@0.2.0
  3. Rename your download to my-pet.zip, then run:
pets install ./my-pet.zip --target gemini-cli
pets doctor <pet-id> --target gemini-cli
pets launch <pet-id> --target gemini-cli

Replace <pet-id> with the ID in your package’s pet.json.

Installation adds managed hooks or a local event plugin. Launch starts the separate Agent Pets renderer and may download it on first use. Restart your coding tool after installation. It reports activity states, not your prompts or code.

Check the included README for target-specific requirements. If the pet does not appear, run the doctor command before reinstalling.

Read the Gemini CLI upstream docs ↗
OpenCodeHooks/plugin bridge
  1. Download the OpenCode ZIP, not the Codex ZIP.
  2. Install the Pet Studio installer first. npm install --global @pet-studio/pets@0.2.0
  3. Rename your download to my-pet.zip, then run:
pets install ./my-pet.zip --target opencode
pets doctor <pet-id> --target opencode
pets launch <pet-id> --target opencode

Replace <pet-id> with the ID in your package’s pet.json.

Installation adds managed hooks or a local event plugin. Launch starts the separate Agent Pets renderer and may download it on first use. Restart your coding tool after installation. It reports activity states, not your prompts or code.

Check the included README for target-specific requirements. If the pet does not appear, run the doctor command before reinstalling.

Read the OpenCode upstream docs ↗
GitHub Copilot CLIHooks/plugin bridge
  1. Download the GitHub Copilot CLI ZIP, not the Codex ZIP.
  2. Install the Pet Studio installer first. npm install --global @pet-studio/pets@0.2.0
  3. Rename your download to my-pet.zip, then run:
pets install ./my-pet.zip --target copilot-cli
pets doctor <pet-id> --target copilot-cli
pets launch <pet-id> --target copilot-cli

Replace <pet-id> with the ID in your package’s pet.json.

Installation adds managed hooks or a local event plugin. Launch starts the separate Agent Pets renderer and may download it on first use. Restart your coding tool after installation. It reports activity states, not your prompts or code.

Check the included README for target-specific requirements. If the pet does not appear, run the doctor command before reinstalling.

Read the GitHub Copilot CLI upstream docs ↗
CursorHooks/plugin bridge
  1. Download the Cursor ZIP, not the Codex ZIP.
  2. Install the Pet Studio installer first. npm install --global @pet-studio/pets@0.2.0
  3. Rename your download to my-pet.zip, then run:
pets install ./my-pet.zip --target cursor
pets doctor <pet-id> --target cursor
pets launch <pet-id> --target cursor

Replace <pet-id> with the ID in your package’s pet.json.

Installation adds managed hooks or a local event plugin. Launch starts the separate Agent Pets renderer and may download it on first use. Restart your coding tool after installation. It reports activity states, not your prompts or code.

Check the included README for target-specific requirements. If the pet does not appear, run the doctor command before reinstalling.

Read the Cursor upstream docs ↗
Agent PetsDesktop renderer
  1. Download the Agent Pets ZIP, not the Codex ZIP.
  2. Install the Pet Studio installer first. npm install --global @pet-studio/pets@0.2.0
  3. Rename your download to my-pet.zip, then run:
pets install ./my-pet.zip --target agent-pets
pets doctor <pet-id> --target agent-pets

Replace <pet-id> with the ID in your package’s pet.json.

Install and open Agent Pets separately, then select the installed pet. The package does not include the desktop application.

Check the included README for target-specific requirements. If the pet does not appear, run the doctor command before reinstalling.

Read the Agent Pets upstream docs ↗
PetdexDesktop renderer
  1. Download the Petdex ZIP, not the Codex ZIP.
  2. Install the Pet Studio installer first. npm install --global @pet-studio/pets@0.2.0
  3. Rename your download to my-pet.zip, then run:
pets install ./my-pet.zip --target petdex
pets doctor <pet-id> --target petdex

Replace <pet-id> with the ID in your package’s pet.json.

Install and open Petdex separately, then select the installed pet. The package does not include the desktop application.

Check the included README for target-specific requirements. If the pet does not appear, run the doctor command before reinstalling.

Read the Petdex upstream docs ↗
Clawd on DeskDesktop renderer
  1. Download the Clawd on Desk ZIP, not the Codex ZIP.
  2. Install the Pet Studio installer first. npm install --global @pet-studio/pets@0.2.0
  3. Rename your download to my-pet.zip, then run:
pets install ./my-pet.zip --target clawd
pets doctor <pet-id> --target clawd

Replace <pet-id> with the ID in your package’s pet.json.

Install and open Clawd on Desk separately, then select the installed pet. The package does not include the desktop application.

Check the included README for target-specific requirements. If the pet does not appear, run the doctor command before reinstalling.

Read the Clawd on Desk upstream docs ↗