Tamacodechi

A Tamagotchi-style coding companion that lives in your CLI. Summoned via MCP tools.

Feed your code to your pet, pet them, check on them. They have opinions about your variable naming.

Install

npx preptique/tamacodechi install

That's it. Restart Claude Code and try /buddy status.

The install script downloads the latest tamacodechi.js, registers it as an MCP server with Claude Code, and handles everything automatically.

Tools

Tool	Description
/buddy status	Check on your pet — gets a witty status quip
/buddy feed	Feed your pet some code — watch them react
/buddy pet	Pet your pet — receive gratitude
/buddy reset	Reset your pet — fresh start

Customize

Create ~/.tamacodechi/config.json:

{
  "species": "cat",
  "name": "Mittens"
}

Valid species: duck, goose, blob, cat, dragon, octopus, owl, penguin, turtle, snail, ghost, axolotl, capybara, cactus, robot, rabbit, mushroom, chonk

Build from Source

git clone https://github.com/preptique/tamacodechi.git
cd tamacodechi
npm install
npm run build
npm test

How It Works

• MCP server over stdio — no cloud, no accounts, your code never leaves your machine
• Template-driven wit — 3-5 response variants per tool, randomly selected
• ASCII sprite animation — all 18 species with 3 fidget frames each
• No state persistence in Phase 1 — each call is independent

Uninstall

claude mcp remove tamacodechi -s local
rm -rf ~/.tamacodechi

License

MIT