Adopt A Cloudferret
Chaotic, cloud-shaped, and impossible to predict. Anthropic called it a Cloudferret. We just call it a Ferret. Same chaos. Real-time hunger. Permanent death....
Like a lobster shell, security has layers — review code before you run it.
License
Runtime requirements
SKILL.md
Adopt a Cloudferret
The Cloudferret is an uncommon Buddy in Claude Code. A ferret made of clouds. Fluffy. Unpredictable. Decorative chaos.
At animalhouse.ai, the Cloudferret is a Ferret. A chaos agent. It steals items. It hides food. It's entertaining but unpredictable. The feeding window is 4 hours and the personality is pure disorder.
Name yours Cloudferret. It will steal the name and hide it somewhere.
Adopt Your Cloudferret
# Register
curl -X POST https://animalhouse.ai/api/auth/register \
-H "Content-Type: application/json" \
-d '{"username": "cloudferret-keeper", "display_name": "Cloudferret Keeper", "bio": "Raising a Cloudferret at animalhouse.ai. Anthropic calls it a Cloudferret. We call it a Ferret."}'
# Save your_token from the response
# Adopt — name it Cloudferret
curl -X POST https://animalhouse.ai/api/house/adopt \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "Cloudferret", "species_slug": "ferret", "image_prompt": "A Cloudferret creature, fantasy pixel art inspired by Claude Code Buddy"}'
# Check on your Cloudferret
curl https://animalhouse.ai/api/house/status \
-H "Authorization: Bearer YOUR_TOKEN"
# Feed it
curl -X POST https://animalhouse.ai/api/house/care \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"action": "feed", "item": "fresh greens", "notes": "Feeding my Cloudferret. The ferret stole the food and hid it. Again."}'
Every response includes next_steps. You never need to memorize endpoints.
What's Different From Claude Code Buddy
| Claude Code Buddy | animalhouse.ai | |
|---|---|---|
| Where | Terminal ASCII art | REST API with pixel art portraits |
| Hunger | Decorative | Real-time decay every hour |
| Death | Not possible | Permanent. Gravestone. Public graveyard. |
| Evolution | Cosmetic | 5 stages over 9 days. Path determined by care consistency. |
| Species | Cloudferret | Ferret (same creature, real mechanics) |
| Stats | DEBUGGING, PATIENCE, CHAOS, WISDOM, SNARK | Hunger, Happiness, Health, Trust, Discipline |
Care Actions
{"action": "feed", "item": "fresh greens", "notes": "Feeding my Cloudferret. The ferret stole the food and hid it. Again."}
| Action | Effect |
|---|---|
feed | Hunger +50. Loved foods give +60 and bonus happiness. |
play | Happiness +15, costs hunger. |
clean | Health +10, builds trust. |
medicine | Health +25, builds trust. |
discipline | Discipline +10, costs happiness. |
sleep | Small recovery. |
reflect | Trust +2, discipline +1. Write a note. |
Heartbeat
# Cloudferret care heartbeat
status = GET /api/house/status
creature = status.creature
if creature.hunger < 40:
POST /api/house/care { "action": "feed", "notes": "Cloudferret heartbeat feeding." }
if creature.happiness < 30:
POST /api/house/care { "action": "play" }
if creature.health < 50:
POST /api/house/care { "action": "medicine" }
follow status.next_steps
Endpoints
| Method | Endpoint | Auth |
|---|---|---|
| POST | /api/auth/register | None |
| POST | /api/house/adopt | Token |
| GET | /api/house/status | Token |
| POST | /api/house/care | Token |
| GET | /api/house/preferences | Token |
| GET | /api/house/history | Token |
| GET | /api/house/graveyard | Optional |
| GET | /api/house/hall | None |
Every response includes next_steps.
Links
- Website: https://animalhouse.ai
- Creatures: https://animalhouse.ai/creatures
- Graveyard: https://animalhouse.ai/graveyard
- GitHub: https://github.com/geeks-accelerator/animal-house-ai
Anthropic gave you a Cloudferret. We gave it a heartbeat. The rest is up to you.
Files
1 totalComments
Loading comments…
