usik

Tamagotchi — AI skill for Claude Code

AI community

A terminal Tamagotchi — raise a virtual pet in your CLI.

How to install Tamagotchi

This entry records only its repository, not the path inside it, so there is no exact command to give. Open usik/tamagotchi and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Tamagotchi does

A terminal Tamagotchi — raise a virtual pet in your CLI. Phase 2: AI agent awareness. Phase 3: peer-to-peer pet visits.

Alternatives in AI

Ccstatusline — by sirmalloc - A highly customizable status line formatter for Claude Code CLI that displays model info, git b 5.5k ★
Pebrel — AI-native, GPU-accelerated terminal emulator for Windows with SSH, persistent sessions, split panes, and first 670 ★
Nebula — AI-native, GPU-accelerated terminal emulator for Windows with SSH, persistent sessions, split panes, and first 587 ★

README

🥚 Tamagotchi — Terminal Virtual Pet

Raise a virtual pet that lives in your terminal. A faithful recreation of the original Tamagotchi — hunger, happiness, sickness, poop, discipline, and care-driven evolution — built for developers who never leave the CLI.

[![PyPI](https://img.shields.io/pypi/v/tamagotchi?style=flat-square&color=blue)](https://pypi.org/project/tamagotchi) [![npm](https://img.shields.io/npm/v/tamagotchi?style=flat-square&color=red)](https://www.npmjs.com/package/tamagotchi) ![Python](https://img.shields.io/badge/python-3.12+-blue?style=flat-square) ![License](https://img.shields.io/badge/license-MIT-green?style=flat-square) ![Status](https://img.shields.io/badge/status-alpha-orange?style=flat-square)

![Tamagotchi demo](docs/assets/demo.gif)

╔═══════════════════════════════════════════════╗
║                                               ║
║     .-----.        Hunger   ████████  4/4     ║
║    ( ^   ^ )       Happy    ████████  4/4     ║
║    (  ___  )       Weight   ████░░░░  12      ║
║     '-----'        Discpln  ██████░░  75%     ║
║     _| | |_        Health   ❤️  OK            ║
║                                               ║
║  🍱 Meal  🍬 Snack  ⭐ Play  🚿 Clean         ║
║  💊 Med   📣 Disc   💡 Light 📊 Status        ║
╚═══════════════════════════════════════════════╝

Features

Full Tamagotchi mechanics — Hunger, Happiness, Weight, Discipline, Health, Poop, Sickness, Lights/Sleep
6 life stages — Egg → Baby → Child → Teen → Adult → Elder
Care-driven evolution — 3 paths (Good / Normal / Poor) based on how well you care for your pet
Real-time aging — pet lives on even when the game is closed
Animated ASCII sprites — unique art per character and mood
AI agent plugins — pet reacts to Claude Code, Aider, and Goose sessions in real time
tama share — generate a shareable ASCII card, copy to clipboard, or embed in your GitHub README
Shell integrations — tmux status bar, Sta