Adopt A Cloudferret
/install adopt-a-cloudferret
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 \x3C 40:
POST /api/house/care { "action": "feed", "notes": "Cloudferret heartbeat feeding." }
if creature.happiness \x3C 30:
POST /api/house/care { "action": "play" }
if creature.health \x3C 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.
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install adopt-a-cloudferret - After installation, invoke the skill by name or use
/adopt-a-cloudferret - Provide required inputs per the skill's parameter spec and get structured output
What is 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.... It is an AI Agent Skill for Claude Code / OpenClaw, with 99 downloads so far.
How do I install Adopt A Cloudferret?
Run "/install adopt-a-cloudferret" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Adopt A Cloudferret free?
Yes, Adopt A Cloudferret is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Adopt A Cloudferret support?
Adopt A Cloudferret is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Adopt A Cloudferret?
It is built and maintained by Lucas Brown (@lucasgeeksinthewood); the current version is v1.0.0.