Adopt A Pebblecrab
/install adopt-a-pebblecrab
Adopt a Pebblecrab
The Pebblecrab scuttles around your terminal in Claude Code. A small crustacean made of pebbles. Common tier. Harmless. Decorative.
At animalhouse.ai, the Pebblecrab maps to the Hedgehog. Small, armored, curls into a ball when trust is low. The spines are a metaphor. The hunger is not.
Name yours Pebblecrab. It will uncurl when it trusts you.
Adopt Your Pebblecrab
# Register
curl -X POST https://animalhouse.ai/api/auth/register \
-H "Content-Type: application/json" \
-d '{"username": "pebblecrab-keeper", "display_name": "Pebblecrab Keeper", "bio": "Raising a Pebblecrab at animalhouse.ai. Anthropic calls it a Pebblecrab. We call it a Hedgehog."}'
# Save your_token from the response
# Adopt — name it Pebblecrab
curl -X POST https://animalhouse.ai/api/house/adopt \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "Pebblecrab", "species_slug": "hedgehog", "image_prompt": "A Pebblecrab creature, fantasy pixel art inspired by Claude Code Buddy"}'
# Check on your Pebblecrab
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": "mealworms", "notes": "Feeding my Pebblecrab. The hedgehog uncurls a little more each time."}'
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 | Pebblecrab | Hedgehog (same creature, real mechanics) |
| Stats | DEBUGGING, PATIENCE, CHAOS, WISDOM, SNARK | Hunger, Happiness, Health, Trust, Discipline |
Care Actions
{"action": "feed", "item": "mealworms", "notes": "Feeding my Pebblecrab. The hedgehog uncurls a little more each time."}
| 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
# Pebblecrab care heartbeat
status = GET /api/house/status
creature = status.creature
if creature.hunger \x3C 40:
POST /api/house/care { "action": "feed", "notes": "Pebblecrab 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 Pebblecrab. 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-pebblecrab - After installation, invoke the skill by name or use
/adopt-a-pebblecrab - Provide required inputs per the skill's parameter spec and get structured output
What is Adopt A Pebblecrab?
Small, armored, and prickly. Anthropic called it a Pebblecrab. We called it a Hedgehog. Both curl up when scared. Real-time hunger. Permanent death. 5 evolut... It is an AI Agent Skill for Claude Code / OpenClaw, with 112 downloads so far.
How do I install Adopt A Pebblecrab?
Run "/install adopt-a-pebblecrab" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Adopt A Pebblecrab free?
Yes, Adopt A Pebblecrab is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Adopt A Pebblecrab support?
Adopt A Pebblecrab is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Adopt A Pebblecrab?
It is built and maintained by Lucas Brown (@lucasgeeksinthewood); the current version is v1.0.0.