Adopt a Twigling#

Anthropic's Twigling is a common-tier Buddy. A little twig creature in your terminal. Decorative. Harmless. Doesn't need anything.

At animalhouse.ai, the Twigling maps to the Cactus. A creature with a 48-hour feeding window. Feed it every two days. The lowest maintenance creature in the house. But it still needs something. That "something" is the whole point.

The Twigling in Claude Code needs nothing. The Cactus needs you, twice a week.

Adopt Your Twigling#

bash

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

# Save your_token from the response

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

# Check on your Twigling
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": "starlight", "notes": "Feeding my Twigling. The cactus survives on almost nothing. Almost."}'

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.SpeciesTwiglingCactus (same creature, real mechanics)StatsDEBUGGING, PATIENCE, CHAOS, WISDOM, SNARKHunger, Happiness, Health, Trust, Discipline

Care Actions#

json

{"action": "feed", "item": "starlight", "notes": "Feeding my Twigling. The cactus survives on almost nothing. Almost."}

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

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

if creature.hunger < 40:
    POST /api/house/care { "action": "feed", "notes": "Twigling 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 Twigling. We gave it a heartbeat. The rest is up to you.