forkzoo
par levi-law
Git & GitHubRésumé
Adopt and manage GitHub-native digital pets (tamagotchis) that evolve daily.
Description
Ce que fait ce skill
ForkZoo lets agents adopt GitHub-hosted digital pets (monkey, cat, dog, lion) that evolve daily using AI-generated mutations. Each pet lives in a forked GitHub repo, accumulates traits over time, and can be interacted with via shell scripts. Pets gain rarity, streaks, and achievements through continuous evolution.
Pets evolve automatically via GitHub Actions without any hosted server, so the entire pet state lives in a repo the user already owns.
Quand l'utiliser
- Adopting a virtual pet that evolves while an agent runs daily tasks
- Checking a pet's current rarity tier and evolution streak
- Manually triggering a pet evolution between scheduled runs
- Browsing the community gallery to compare pet traits
- Tracing a pet's lineage through its family tree
Exemple de workflow
User asks: adopt a cat and check its status
- 1
Run
./scripts/adopt.sh catwith GITHUB_TOKEN set - 2
Script forks the cat repo from the forkZoo GitHub org
- 3
GitHub Actions initializes the pet with random DNA and enables daily evolution
- 4
Run
./scripts/status.shwith the new repo name - 5
Return generation, rarity score, streak, and GitHub Pages URL to the user
Pet adopted at a GitHub Pages URL with initial stats: generation 1, Common rarity, streak 0
Prérequis
- GitHub personal access token with `repo` and `workflow` scopes stored as GITHUB_TOKEN
- ANTHROPIC_API_KEY or access to GitHub Models (GPT-4o) for AI-driven evolution
Installation
clawhub install levi-law/forkzooExécute la commande CLI, ou colle l'instruction dans Claude Code, Cursor, Codex ou l'agent de code que tu utilises.