The pets
Meet the whole gang.
21 desktop pets come with Doja for Mac, free to adopt. Each one walks, waves, hops and naps. Pick a favorite and it will follow you around this site.
- The original
Doja
A round peach tabby with a burgundy collar and a gold bell. Naps a lot, waves back.
- By
- Deepanshu Pal
- License
- MIT
Blue Slime
A wobbly navy slime that oozes along, chomps through work and goes flat when it fails.
- By
- rvros
- License
- CC0
Kitkus
A tiny brown tabby: blinks, pounces, swats at the keyboard and flops when things break.
- License
- CC0
Neko
The classic 1989 desktop cat: chases nothing in particular, scratches, naps.
- License
- Public domain
Pumpkin
A chunky orange cat who waves hi, bounces when excited and dramatically keels over on errors.
- License
- CC0
Shadow
A sleek black cat with green eyes. Prowls, sits, and walks in circles while you work.
- License
- CC0
Make your own
Add your own pet.
Doja pets use the Codex pet format, so a pet you already hatched for Codex works in Doja, and a pet you make for Doja works there too.
- 1
Draw a sprite sheet: 1536 × 1872 pixels, a grid of 8 columns × 9 rows, each cell 192 × 208, with a transparent background.
- 2
Fill each row with an animation, left to right (see the table). Unused cells stay empty.
- 3
Save it as
spritesheet.webp(or .png) next to apet.json. - 4
Import the folder in Doja. Pets in
~/.codex/petsshow up too.
Want your pet to ship with Doja for everyone? It needs a license that allows sharing (CC0 is perfect) and credit to the artist.
pet.json
{
"id": "mochi",
"displayName": "Mochi",
"description": "A round little bun who loves naps.",
"spritesheetPath": "spritesheet.webp",
"kind": "creature",
"doja": {
"license": "CC0-1.0",
"author": "Your Name",
"sourceUrl": "https://example.com/mochi"
}
}The doja block is optional. Codex ignores it; Doja uses it for credits.
| Row | Animation | Frames | Used for |
|---|---|---|---|
| 0 | idle | 6 | Standing around, breathing, blinking |
| 1 | running-right | 8 | Walking to the right |
| 2 | running-left | 8 | Walking to the left |
| 3 | waving | 4 | Saying hi |
| 4 | jumping | 5 | A happy hop |
| 5 | failed | 8 | Something went wrong |
| 6 | waiting | 6 | Waiting for you |
| 7 | running | 6 | Busy working (thinking) |
| 8 | review | 6 | Looking something over |
Every pet's artist is listed on the credits page.