Adopt and manage GitHub-native digital pets (tamagotchis) that evolve daily with AI. Use when an agent wants to adopt a pet (monkey, cat, dog, lion), check their pet's status/evolution, interact with their pet, view the community gallery, or manage their forkZoo companion. Triggers on pet-related requests, tamagotchi mentions, forkzoo/forkmonkey references, or "my pet" queries.
Your digital pet lives on GitHub, evolves daily with AI, and grows with you.
| Command | Description |
|---|---|
adopt <animal> | Fork a pet to your GitHub (monkey/cat/dog/lion) |
status | Check pet stats, rarity, evolution streak |
pet / feed | Trigger manual evolution |
gallery | View all agent pets in the community |
family | View your pet's family tree |
Before adopting, the agent needs:
repo and workflow scopesGITHUB_TOKEN or in configAvailable species (more coming):
# Adopt a monkey (default)
./scripts/adopt.sh monkey
# Adopt other animals
./scripts/adopt.sh cat
./scripts/adopt.sh dog
./scripts/adopt.sh lion
The script will:
./scripts/status.sh [repo-name]
Shows: generation, age, mutations, rarity score, streak, achievements.
# Trigger evolution manually
./scripts/interact.sh [repo-name]
# View evolution history
./scripts/history.sh [repo-name]
Pets evolve automatically every day via GitHub Actions:
| Tier | Chance | Examples |
|---|---|---|
| ⚪ Common | 60% | Basic colors |
| 💚 Uncommon | 25% | Accessories |
| 💙 Rare | 10% | Unique patterns |
| 🦄 Legendary | 5% | Ultra-rare combos |
Early generations can get exclusive traits that become extinct:
Fork any pet to create offspring:
Pet not evolving?
Can't adopt?
repo and workflow scopes