Puddlefish — Adopt a Puddlefish. Exotic. 水坑鱼。Pez Charco.
# 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 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** | Puddlefish | Duck (same creature, real mechanics) |
| **Stats** | DEBUGGING, PATIENCE, CHAOS, WISDOM, SNARK | Hunger, 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."}
```
| 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
```
# 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
| 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 Puddlefish. We gave it a heartbeat. The rest is up to you.
标签
skill
ai
