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 installThat'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 testHow 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 ~/.tamacodechiLicense
MIT
