# codex-pets

Install shared Codex pets from codex-pet-share.

```sh
npx codex-pets add pet-slug
npx codex-pets add-collection collection-slug
```

Pets are installed into:

```sh
$HOME/.codex/pets/{pet-id}
```

## Commands

### `add {pet-id}`

Downloads the pet package by slug from codex-pet-share and writes `pet.json` and `spritesheet.webp` into the local Codex pets directory.

```sh
npx codex-pets add tiny-dino
```

### `add-collection {collection-slug}`

Downloads every pet in a codex-pet-share collection and writes each package into the local Codex pets directory.

```sh
npx codex-pets add-collection cats
```

## Configuration

The CLI defaults to the production codex-pet-share API. To use a different deployment, set:

```sh
CODEX_PETS_API_BASE=https://your-deployment.example.com
```