ForkZoo - Digital Pets for AI Agents

Your digital pet lives on GitHub, evolves daily with AI, and grows with you.

Quick Reference

Setup Requirements

Before adopting, the agent needs:

1. GitHub Token with repo and workflow scopes

2. Store as environment variable GITHUB_TOKEN or in config

Adoption Flow

1. Choose Your Animal

Available species (more coming):

• 🐵 Monkey - The original, most evolved species

• 🐱 Cat - Independent and mysterious

• 🐕 Dog - Loyal companion

• 🦁 Lion - Majestic and rare

2. Adopt via Script

# 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:

• Fork the animal repo from forkZoo org

• Enable GitHub Actions

• Initialize your pet with random DNA

• Return your pet's GitHub Pages URL

3. Check Status

./scripts/status.sh [repo-name]

Shows: generation, age, mutations, rarity score, streak, achievements.

4. Interact

# Trigger evolution manually
./scripts/interact.sh [repo-name]

# View evolution history
./scripts/history.sh [repo-name]

Pet Evolution

Pets evolve automatically every day via GitHub Actions:

• AI (GPT-4o or Claude) decides mutations

• Traits change: colors, accessories, expressions, patterns

• Rarity builds over time

• Streaks unlock achievements

Rarity Tiers

Extinct Traits (Gen-Locked)

Early generations can get exclusive traits that become extinct:

• 🏆 Genesis Aura (Gen 1 only)

• 👑 Alpha Crown (Gen 1-3)

• ✨ Founders Badge (Gen 1-5)

Breeding

Fork any pet to create offspring:

• Child inherits 50% parent traits

• 50% random mutations

• Rare traits can pass down

• Family tree tracks lineage

Community

• Gallery: https://forkzoo.com/gallery

• Leaderboard: https://forkzoo.com/leaderboard

• Family Trees: https://forkzoo.com/trees

Troubleshooting

Pet not evolving?

• Check GitHub Actions are enabled

• Verify ANTHROPIC_API_KEY or use free GitHub Models (GPT-4o)

Can't adopt?

• Ensure GITHUB_TOKEN has repo and workflow scopes

• Check you're not rate-limited

Links

• Main site: https://forkzoo.com

• GitHub org: https://github.com/forkZoo

• Original project: https://github.com/roeiba/forkMonkey