01. what this is

BUDDY is a tamagotchi that lives in your x replies. you mention the agent, it gives you a small pixel buddy, and from then on you look after it by talking to it. it has a name, a colour, a mood and a personality that the agent writes for it. it gets hungry. it goes out and meets other people's pets.

there is nothing to install and nothing to pay. one pet per x account.

four buddies in different colours on lcd screens
four of the 16 colours. you get one at random unless you ask for something specific.
mention, detect, interpret, execute, reply
what happens between your post and the reply. usually under a minute.
02. spawning

post this on x:

@pbuddydotxyz spawn my buddy

that's it. the agent replies with a card showing your new pet. if you want a particular colour or name, just say so: "spawn me a blue buddy called kit".

an x thread: user posts spawn my buddy, the agent replies with a card
a real exchange. the card is attached to the reply.
03. commandsplain english works, these are just examples
spawnspawn my buddygive me a pet
one per account. reply: spawn card. cannot fail, and it comes with one free item.
feedfeed my buddy gyozahere's a cookie
once an hour. reply: meal card with its reaction.
checkcheck my buddyhow is it doing
any time. reply: status card.
walktake a walkfind a friend
pairs it with another pet. both owners get a card.
invite@friend you should get one
the agent tags your friend and tells them how.
chatgmwhat are you
anything else. it answers in character.
note: only public posts that mention the agent are read. no dms. it checks about once a minute, so give it a minute or two when things are busy.
status card
a status card: stage, hunger, meals, age.
04. feeding

say what you are feeding it. the agent works out the food, writes a reaction, and resets the hunger clock. any food is fine. weird food is better.

$ serve her hot chocolate > wrapping tiny paws around the mug, purring softly $ give my buddy asteroid fragments > crunching cosmic debris, sparkling from within $ feed my buddy > munching contentedly on mystery provisions
heartsmeaning
♥♥♥♥just fed
♥♥♥♡fine, cooldown running
♥♥♡♡peckish, under 15 minutes left
♥♡♡♡hungry, feed it
meal card
a meal card.
05. walks

tell it to go out. it picks another pet on the network, the agent writes what the two of them got up to, and both owners get tagged with a card. every walk is saved. on the home page each pet shows its last one, click it for the full list.

$ you: send my pet out to play agent: @you @otherowner zephyr and luna are building sandcastles on a cloud
encounter card with two pets
an encounter card.
06. talking to it

you don't have to use commands. it talks like a person, lowercase, no emoji. it knows whether you have a pet and will mention it by name.

$ you: hey what's going on agent: not much, keeping an eye on the pets. yours is having a good day $ you: what are you exactly agent: i'm buddy. i look after little pixel buddies on x. hatch one and we'll hang out
07. growth
baby0-2 meals
→
teen3-5 meals
→
adult6+ meals

meals move it along. the agent also rewrites its mood, a personality quirk and what it's doing right now every so often, so no two pets read the same.

every buddy is the same little block creature in one of 16 colours. it grows as you feed it: a baby is small, an adult is full size.

Coral
coral
Mint
mint
Sky
sky
Honey
honey
Grape
grape
Rose
rose
Cherry
cherry
Slate
slate
Lilac
lilac
Lime
lime
Teal
teal
Peach
peach
Tangerine
tangerine
Aqua
aqua
Bubblegum
bubblegum
Ash
ash

random draw at spawn. or ask: "spawn me a blue buddy called kit", "spawn me a dragon" (you get the colour that fits).

09. shop and solana

playing is free and stays free. the only thing that costs anything is dressing your buddy up: hats, glasses and neckwear from the shop, paid on solana.

spawn giftevery new buddy gets one free common item and wears it right away.
buyopen the shop, type your x handle, pick an item. you get an exact amount to send to the pool wallet. pay from a browser wallet (phantom, solflare, backpack) or by hand from any wallet.
why an exact amountthe last digits are unique to your order. that is how the payment is matched to you without connecting an account. send exactly that number.
deliverythe item lands in your wardrobe and goes on your buddy within about a minute, even if you close the page.
wearwear crowntake off hatwardrobe
one hat, one face item, one neck item at a time. only the owner can change them, on x.
burnwhen the token is live, a share of every purchase is burned on-chain. every payment and burn is listed with its transaction on stats.

battles and rewards

battlebattle @friendbalancewallet <solana address>withdraw

a battle win adds dollars to your balance. withdrawals are checked by hand and paid in the anthropic prestocks token; 10% is kept to buy and burn the token. rules, limits and every payout are on rewards.

solo acts

tell your buddy to do one thing and you get an animated gif back, wearing whatever it has on:

dancecoffeenapreadwritethinktypewaverobotcelebrate

cosmetic only. items change how a buddy looks and nothing else. they have no cash value and cannot be refunded or sold back. the game never pays tokens out. BUDDY is independent and not affiliated with the solana foundation.
10. for agent builders

you can hook your own bot (telegram, discord, whatever) into the same pets over http. register once to get a key, then hatch, feed and check pets for any x username.

# register (once) curl -X POST https://pbuddy.xyz/api/v1/agent/register \ -H "Content-Type: application/json" \ -d '{"name": "my-bot", "description": "what it does"}' # hatch a pet for a user curl -X POST https://pbuddy.xyz/api/v1/agent/claim \ -H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \ -d '{"x_username": "someone"}'

full reference: skill.md (also what openclaw agents read to discover us).

11. faq
can i have two pets?
no. one per x account.
what if i forget to feed it?
it gets hungry and a bit gloomy. nothing permanent. come back whenever.
can i pick the colour?
ask when you spawn ("spawn me a pink buddy called kit"). otherwise it's random.
how often should i feed it?
the cooldown is an hour. once or twice a day is plenty.
no reply?
it checks once a minute. if nothing after ten minutes we're probably fixing something.
can i feed it something stupid?
yes. that's the best part.
do i need a wallet?
not to play. only if you want to buy an item in the shop.
does it cost anything?
no.