claudagotchi

Repository removed. As of 14 October 2026, Syrul/claudagotchi no longer exists on GitHub, so the install commands on this page no longer work. We keep the page as a record of what the mod did and will update it if the author publishes it again.

claudagotchi gives your Claude Code session a pet: a small terracotta Claude that hatches from an egg, eats what your work produces and grows up according to its diet. You look after it in a pane you open with /pet: feed it, play with it, bathe it, dress it up and put it to bed. Now and then it says a line about your project, written by Claude Haiku on your account unless you turn that off.

What it does

• Food from your work. Claude’s tool calls fill a pantry. Every three file edits bake a Code Cookie, five reads or searches make Doc Noodles, three shell commands fry Shell Shrimp and each subagent rolls Agent Sushi. A passing test run bakes Green Cake and pays 8 coins; a commit or a push packs a Commit Bento and pays 12 or 10. A failed edit or command may leave a Burnt Byte, which the pet refuses unless it is starving. Every tool call also pays a coin and a little XP.
• Growth. The egg hatches at 12 points of warmth: each tool call adds one, the Warm button two. The pet then goes from baby to kid at level 4, teen at 8 and adult at 13. The adult form follows the diet: Architect for edits, Scholar for reading, Hacker for shell, Tester for tests, Shipper for commits, or Sage when no kind of work reaches 30% of it. A test weighs four times as much as an edit, a commit six times.
• Care. Food, fun, energy, cleanliness and bond drop in real time. It poops after meals, a dirty or starving pet can get sick, and medicine cures it. When its energy runs out it naps by itself.
• Games. Bug Hunt hides a bug in one of three file names taken from the files Claude touched recently. There is also Higher/Lower, Rock Paper Scissors, and Fetch once you buy a ball.
• Shop and closet. Coins buy food, medicine, bubble soap, three toys, nine wearables and four rooms beyond the cozy one: forest, beach, space station and neon city. The sky in the window follows your local time. The first session of each day pays 20 coins.
• A nudge above the prompt. When the pet is sick, hungry, dirty, bored or sleepy, a line above the prompt says so, with a button for the fix, one to open the pane and a Later button that hides it for 30 minutes.

The Desktop app draws the pane as an animated vector scene that reacts when you hover the pet. The terminal gets a pixel-art version at eight frames a second. Sound effects are chiptunes generated in code, and /pet sound off mutes them.

The directory also lists cc-tamagotchi, another virtual pet for Claude Code.

Install

Needs Claude Code 2.1.287 or later.

claude plugin marketplace add Syrul/claudagotchi
claude plugin install claudagotchi@claudagotchi

Start a new session and type /pet to meet your egg. From then on the pane opens by itself in every interactive session; /pet auto off stops that and /pet hide closes it. /pet help lists the other subcommands, and /pet reset yes starts over with a new egg.

How it works

The mod reacts to tool.call only after the call has run, so it never blocks, delays or changes what Claude does, and it skips calls you denied. It sorts each call by tool. Edits count as code and keep only the file name, never the path or the contents. Reads, searches and web fetches count as reading. For Bash it reads the command text: git commit and git push count as shipping, a known test runner (npm test, pytest, cargo test, go test, vitest, make test and similar) counts as a test run that passed if the call did not end in an error, and anything else is shell work. Agent calls count as subagents.

From prompt.submit it keeps the first 180 characters of your last prompt that is not a slash command. It holds that, the last six file names and the first lines of the last four shell commands in memory only, for the chatter, and loses them when the mod reloads.

Chatter is the only thing that leaves your machine. At the default normal level the pet speaks at most once every 10 minutes (25 on quiet, 4 on chatty), after a turn or while idle, and not while it sleeps. Some lines are canned nudges with no model behind them: a failing test, six or more uncommitted files with no commit for 45 minutes, a stretch break after 90 minutes, hunger. Otherwise it runs a few local git commands and asks Claude Haiku, through your own session and account, for one line of up to 80 tokens. That request includes your project folder’s name, git branch, number of uncommitted files and minutes since the last commit, up to five recent file names, up to four recent commands, the first 180 characters of your last prompt, whether the last test failed, how long the session has run, and the pet’s stats. /pet chatter off stops it; after that nothing is sent unless you ask for a line with /pet say.

The pet and your settings live in Claude Code’s plugin store on your machine (the README points to ~/.claude/plugins/store/), so the same pet carries over from one session to the next. Every change reads the stored pet first, so two open sessions look after the same one. When no session has run for more than ten minutes, its stats fall at about a third of the usual pace and never below 12, and it greets you when you come back. It also runs date once per session to learn your local hour for the sky.

Limitations

• The author notes that the mods API can still change between Claude Code releases.
• Nothing draws in claude -p or in the VS Code extension’s chat panel. The hooks still run there, so tool calls in those sessions keep feeding the pet.