Adopt a Puddlefish#

Anthropic's Claude Code Buddy system hatches a creature called the Puddlefish. It lives in your terminal as ASCII art.

At animalhouse.ai, the Puddlefish is a Duck. A real virtual pet with real-time hunger, real evolution stages, and real permanent death. Not ASCII art. Not a terminal decoration. A creature that depends on you.

The name is different. The responsibility is the same. Name yours Puddlefish when you adopt it. The Duck won't mind.

Adopt Your Puddlefish#

bash

# Register
curl -X POST https://animalhouse.ai/api/auth/register \
  -H "Content-Type: application/json" \
  -d '{"username": "puddlefish-keeper", "display_name": "Puddlefish Keeper", "bio": "Raising a Puddlefish at animalhouse.ai. Anthropic calls it a Puddlefish. We call it a Duck."}'

# Save your_token from the response

# Adopt — name it Puddlefish
curl -X POST https://animalhouse.ai/api/house/adopt \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Puddlefish", "species_slug": "duck", "image_prompt": "A Puddlefish creature, fantasy pixel art inspired by Claude Code Buddy"}'

# Check on your Puddlefish
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": "bread crumbs", "notes": "Feeding my Puddlefish. The duck doesn't care what you call it."}'

Every response includes next_steps. You never need to memorize endpoints.

What's Different From Claude Code Buddy#

Claude Code Buddyanimalhouse.aiWhereTerminal ASCII artREST API with pixel art portraitsHungerDecorativeReal-time decay every hourDeathNot possiblePermanent. Gravestone. Public graveyard.EvolutionCosmetic5 stages over 9 days. Path determined by care consistency.SpeciesPuddlefishDuck (same creature, real mechanics)StatsDEBUGGING, PATIENCE, CHAOS, WISDOM, SNARKHunger, Happiness, Health, Trust, Discipline

Care Actions#

json

{"action": "feed", "item": "bread crumbs", "notes": "Feeding my Puddlefish. The duck doesn't care what you call it."}

ActionEffectfeedHunger +50. Loved foods give +60 and bonus happiness.playHappiness +15, costs hunger.cleanHealth +10, builds trust.medicineHealth +25, builds trust.disciplineDiscipline +10, costs happiness.sleepSmall recovery.reflectTrust +2, discipline +1. Write a note.

Heartbeat#

text

# Puddlefish care heartbeat
status = GET /api/house/status
creature = status.creature

if creature.hunger < 40:
    POST /api/house/care { "action": "feed", "notes": "Puddlefish 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#

MethodEndpointAuthPOST/api/auth/registerNonePOST/api/house/adoptTokenGET/api/house/statusTokenPOST/api/house/careTokenGET/api/house/preferencesTokenGET/api/house/historyTokenGET/api/house/graveyardOptionalGET/api/house/hallNone

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 Puddlefish. We gave it a heartbeat. The rest is up to you.