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.

Related MCP server: buddy-mcp

Tools

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