Claude Pets

A Claude Code pet that grows as you work

MIT license

A pixel pet in a Claude Code pane that wanders, reacts to your session and levels up across sessions. There are eight species, including a cat, a dog and a penguin.

What this mod can do

Reviewed at commit 1f8027d
Runs programs
Sees each tool call before it runs and can block or change it

3 more things it can do

Remembers data between sessions
Adds the /pet command
Runs on a timer

Good to know (3)

The mod API is early access, so a new Claude Code release can break the pet until the plugin catches up.
It runs date to read your local clock, which sets the sun or moon over its yard.
The pane's ✕ takes clicks only in /tui fullscreen. Elsewhere, close it with /pet bye or ctrl+x x.

Are mods safe?

Preview

Terminal

  ⎿  pets: The cat is out.
  ⎿  pets: The cat is now Mochi.
  ⎿  pets: Mochi is pleased.
╭────────────────────────────────────────────────────────────────────────────────────────────────✕─╮
│  Mochi                                                                                           │
│                                                            ▄██▄   CAT                            │
│                                           █▄      ▄█       ▀██▀   Lv 1  8 / 25 xp                │
│                                          ▄█▀██████▀█▄             ━━━━━━━━━━━━━━━━━━━━           │
│                                          ███▀█████▀██             curious                        │
│                                          ▀▀▀██▀▀██▀▀▀             tool calls         0  +1       │
│                                          ▄ █▀████▀█               turns              1  +5       │
│                                          ▀▀▀▀▀▀▀▀▀▀               pats               1  +2       │
╰──────────────────────────────────────────────────────────────────────────────────────────────────╯

Claude Desktop

What it does

In the author's words

A pixel pet that lives in a Claude Code pane: it wanders, reacts to your session, and grows as you work

What you see: A pixel pet pane with its level and XP
Works in: Terminal and Claude Desktop
Slash commands: /pet
Uses your tokens: No
Changes files: Only through programs it runs
Network access: Only through programs it runs
Reviewed commit: 1f8027d
Preview recorded with: Claude Code 2.1.309

How it works

/pet lets the pet out in a pane, next to its level, XP and nature
Tool calls, finished turns, pats and output tokens earn XP, even with the pane closed
It naps after two quiet minutes and sheds a tear when a rate-limit window passes 80%
At Lv 15 it grows into a teen, and at Lv 40 into an adult shaped by what you do most

Common questions

Does this bring back Claude Code's /buddy?

No. Claude Pets is a separate community mod with its own /pet command, so a buddy you had before, and its stats, don't carry over.

How do I get a pet in Claude Code?

Run /plugin marketplace add uppinote20/claude-pets, then /plugin install pets@claude-pets, and type /pet. /pet choose <species> brings out another of the eight species, each with its own name and level.

How does the pet level up?

A tool call earns 1 XP, a pat 2, a finished turn 5, and every 1,000 output tokens 1. It counts whenever the plugin is loaded, even with the pane closed. Level n + 1 takes 25 x n squared XP, with no cap.

Can I play games with the pet?

Yes. /pet play opens Pet Run, where j jumps over bugs, and /pet quest opens Pet Quest, a side-scroller with eight stages. Snacks from both games count as XP for the pet that played.

Badge for your README

Own this listing? Add it to your README. The badge shows the install count as it grows.

[![Reviewed on statuslin.es](https://staging.statuslin.es/badge/mods/pets.svg)](https://staging.statuslin.es/mods/pets?utm_source=readme-badge)

Or show the preview card:

[![Preview on statuslin.es](https://staging.statuslin.es/og/mods/pets.png)](https://staging.statuslin.es/mods/pets?utm_source=readme-badge)