#adopt #cloudferret #animalhouse #anthropic

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. 5 evolution stages. At animalhouse.ai, the Cloudferret is a Ferret.

Lucas Brown@lucasgeeksinthewood

Install

openclaw skills install @lucasgeeksinthewood/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

bash

# 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

json

{"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

text

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