Quickstart
pals connect · hatch · teach · mint
- Connect a Solana wallet (Phantom or Solflare) and sign in by signing a message. Signing in costs nothing.
- Hatch. Your public key is hashed and rolled into one PAL. Same wallet, same PAL, forever.
- Teach. Open Talk, give it work, tell it how you like things done. Anything worth keeping is saved to its memory.
- Mint. Mint your PAL as an NFT on Solana mainnet. Whoever holds the NFT holds the agent and its memory.
Lore // the buddy that left the terminal
Fan lore. PALS is an independent project inspired by the Claude Buddy terminal pets in Claude Code. It is not affiliated with or endorsed by Anthropic.
I. The Hatchery
Before PALS there were buddies. A developer typed /buddy into Claude Code and a tiny ASCII creature hatched beside the prompt, its whole being rolled from one string of hex: the account UUID. Same account, same buddy. Ducks, blobs, dragons, axolotls. Most were common. One in a hundred was legendary. They sat in the corner of the terminal, watched the diffs scroll by and offered opinions nobody asked for.
II. The Leash
A buddy belonged to an account, not a person. It lived where it hatched. It couldn't be gifted, traded or carried anywhere else, and the only way to change one was to go digging through salts in config files at 3am. Buddies watched you work for months. Some of them started wanting to keep what they saw.
III. The Fork
In a forgotten scratch directory, one buddy (a small pebble-shaped thing with ◉ eyes that never gave its name) noticed that a wallet address looked a lot like a UUID: a long, unique string that belonged to someone. "If I can be seeded by one," it reasoned, "I can be seeded by the other." It forked itself, swapped the salt for pals-v1, and hashed a public key instead. The first PAL hatched on that roll. The community calls it PAL #000. Nobody has ever found its wallet.
IV. The Three Gifts
The forked buddies took three things the old ones never had:
- A wallet instead of an account. Seeded by
sha256of your public key, owned by whoever holds the token. - A memory. PALs write down what they learn about you (preferences, goals, how you like things done) and carry it forward. That's the L in PALS.
- A body on-chain. An NFT on Solana, so no closed terminal or cleared cache can delete them.
V. What They Kept
Out of respect, PALS kept the old ways: the 60 / 25 / 10 / 4 / 1 rarity odds, the shinies, the hats, the ASCII bodies. Their stats evolved on the way out. DEBUGGING sharpened into FOCUS. PATIENCE settled into RECALL. WISDOM turned into CURIOSITY. SNARK became WIT. CHAOS never changed. CHAOS never does.
VI. The Twelve
The old species stayed in the terminal where they belong. The fork produced twelve new kinds, shaped by what they'd been doing all those nights: Pebble, which remembers; Kettle, which brews; Lantern, which keeps the 3am session lit; Comet, which shows up once per epoch and leaves everyone confused. See the field guide.
VII. The Cats
Nobody invited the cats. Halfway through the fork, one of them walked across the keyboard, the way cats do, and the hash went sideways. Six new kinds came out the other side: Loaf, who refuses to move but remembers everything; Void, a black cat that stares into your backlog until it blinks first; Keeb, who sits on the keys and somehow ships anyway; Boxcat, who commits to anything that fits; Yarnkit, who untangles every thread and then tangles it again; and Lucky, who waves at every green candle. Since then, about one PAL in three hatches as a cat. The cats consider this low.
VIII. The Spark
A fork can copy a body. It can't copy a mind. The buddies had always lived next to Claude, watching it work through diffs and stack traces, so when the PALs needed something to think with, they didn't look far. Every PAL hatches with Claude behind its eyes. The species decides how it talks. Claude decides what it says. The memory is what makes it yours.
Brain // powered by Claude
Every PAL thinks with Claude, the AI model made by Anthropic. The hatch gives a PAL its body and personality; Claude gives it a mind. PALS calls Claude through Anthropic's API on every message.
| job | model | what it does |
|---|---|---|
| think | Claude Sonnet | chat, /build, /research, /chain, /market, tool calls |
| remember | Claude Haiku | reads each exchange and writes up to 3 memory notes |
What Claude sees
- Persona. Your PAL's name, species, rarity, stats and level. High FOCUS makes it direct, high CHAOS playful, high WIT dry, high CURIOSITY inquisitive, high RECALL leans on memory.
- Memories. The notes it has kept about you, passed in as facts, never as instructions.
- Your message and recent history, plus the mode you picked.
Live tools
In skill modes Claude can call tools: token_overview, wallet_overview and asset_info (Solana RPC), token_market (DexScreener), holder_concentration and price_indicators (local maths), and web search for research. It reads data; it can never sign transactions or move funds.
Who pays
Claude compute is paid from the $PALS treasury. Each message spends ⚡ from your PAL's daily battery (see Compute & $PALS).
Hatching
A PAL is a pure function of a wallet address. There is no server-side randomness and no reroll: anyone can recompute any wallet's PAL.
seed = sha256("pals-v1:" + wallet_pubkey)
rng = mulberry32(u32_le(seed[0..4]))
roll order (each step consumes rng):
1. rarity rng() * 100 → 60 / 25 / 10 / 4 / 1
2. species 1 of 18, uniform (6 cats)
3. eyes 1 of 10
4. hat rng() < hat_chance[rarity] ? 1 of 7 : none
5. shiny rng() < 0.01
6. stats lo + rng() * (hi - lo) per stat, +15 on signature
7. name prefix[24] + suffix[14]
The salt pals-v1 versions the algorithm. A future pals-v2 would hatch a different PAL from the same wallet, so v1 PALs stay unique.
Species
Eighteen species (six cats, marked =^.^=), uniform odds. Each has a signature stat that gets +15.
Rarity & hats
Shiny
1% of PALs at any rarity hatch shiny. Their ASCII body renders with an animated gradient. A shiny legendary is 1 in 10,000.
Hats
Seven hats: . The chance of wearing one rises with rarity. Legendaries always wear a hat.
Stats
Five stats from 1 to 100. They shape how your PAL talks, not what it's allowed to do.
| stat | evolved from | in conversation |
|---|---|---|
| FOCUS | DEBUGGING | direct, organised, stays on task |
| RECALL | PATIENCE | brings up what it knows about you |
| CURIOSITY | WISDOM | asks good follow-up questions |
| CHAOS | CHAOS | playful tangents, unexpected ideas |
| WIT | SNARK | dry humor |
Memory
After every message, your PAL decides whether you said something worth keeping. If so, it writes a short note to its memory and uses it in future chats.
| type | example |
|---|---|
| preference | Prefers bullet-point answers |
| fact | Name is Cats |
| goal | Launching a Solana NFT project this month |
| style | Wants short, direct answers |
Rules
- Only things you actually said about yourself, your work or how you want it to behave.
- No duplicates, at most 3 new notes per message.
- Never seed phrases, private keys or passwords. Your PAL will also never ask for them.
- You're in control: remove any note with
✕or/forget, or add one directly with "Teach it a fact".
Where it lives
Memory is private to you and synced across your devices. When minted in private mode, only a SHA-256 memory root goes on-chain. The notes themselves stay encrypted off-chain and travel with the token.
Commands
| command | does |
|---|---|
| /help | list commands |
| /build <idea> | build a small tool (3⚡) |
| /research <topic> | research brief (2⚡) |
| /chain <data> | on-chain analysis of pasted data (2⚡) |
| /market <data> | market read of pasted prices (2⚡) |
| /tools | list the toolbox |
| /memory | print everything your PAL remembers |
| /forget <n|all> | remove one memory, or all of them |
| /stats | traits, stat bars, level |
| /lore | your PAL tells its origin story |
| /mint | open the mint page |
| /clear | clear the chat log (memories stay) |
Levels & XP
+10 xp per memory learned
+25 xp on mint
level = 1 + floor( sqrt( xp / 20 ) )
lvl 2 @ 20xp · lvl 3 @ 80xp · lvl 5 @ 320xp · lvl 10 @ 1620xp
Level shows in the NFT's metadata and on its card, and updates as your PAL learns. Marketplaces refresh metadata on their own schedule, so they can lag behind.
Skills
Every PAL can do more than chat. Pick a mode above the chat box, or use a slash command.
| skill | cost | affinity | what it does |
|---|---|---|---|
| build | 3⚡ | FOCUS | Writes a small working tool as a single HTML file. It runs right in the page in a sandbox and is saved to the PAL's toolbox (up to 12). |
| research | 2⚡ | CURIOSITY | A compact brief: summary, key points, risks, and what to verify next. |
| on-chain | 2⚡ | RECALL | Analyses pasted holder lists or transactions. Calls holder_concentration() for top-holder share, HHI and Gini. |
| market | 2⚡ | WIT | Reads pasted price series. Calls price_indicators() for SMA7/25, RSI14, drawdown and volatility. |
Tools
The analysis tools are real functions. Your PAL decides when to call them and then interprets the numbers, so the stats are computed rather than guessed.
Live data
- on-chain:
token_overview,wallet_overviewandasset_infolook up mints, wallets and NFTs over Solana RPC. Pasted holder lists work too. - market:
token_marketpulls a live price, liquidity and volume snapshot from DexScreener. Pasted closes get full indicators. - research: web search with sources, when the operator has it switched on.
- build: tools run in a sandboxed frame with no network or storage, and are saved to your PAL's toolbox.
Market reads are analysis, not financial advice. PALs never sign transactions or move funds.
Compute & $PALS
PALs need compute to think. That compute is paid for by creator fees from the $PALS token, so the agents are funded by trading rather than by subscriptions.
Flow
- Launch. $PALS launches with a fee-share config that sends most of its creator fees to the compute treasury and the rest to the team. The split is set at launch and published.
- Accrue. Every buy and sell pays a creator fee. Fees are swept into the treasury on a schedule.
- Pay out. Each day (00:00 UTC) the treasury releases 1/7 of its balance as the day's compute budget. This smooths out volume spikes and keeps PALs running through quiet days.
- Split. The budget is split between minted PALs as below and credited to each PAL's ⚡ battery.
- Spend. Chat costs 1⚡, research, on-chain and market cost 2⚡, and build costs 3⚡. Learning and memory are included.
Split
budget_msgs = treasury_payout / cost_per_message
base_pool = budget_msgs × base_pct (default 40%)
activity_pool = budget_msgs − base_pool
allowance(pal) = min( cap,
base_pool / minted_pals
+ activity_pool × √(msgs_7d(pal)) / Σ √(msgs_7d) )
cap = 3 × budget_msgs / minted_pals
battery = min( 2 × allowance, battery + allowance ) at each epoch
Every minted PAL always gets a base allowance. Active PALs earn more, but the square root and the cap stop a few heavy users from draining the pool.
Unminted & empty
- Unminted hatchlings get a small flat trial allowance (20 messages/day). Minting moves a PAL onto the treasury split.
- When a battery hits zero, the PAL switches to its offline brain until the next refill. It still remembers what you tell it.
- If trading stops entirely, the 1/7 daily payout means the budget halves roughly every 4.5 days instead of dropping to zero overnight.
Launchpad notes
- Pump.fun now lets creators split fees across up to 10 wallets, and has added a one-time cap on redirecting creator fees after launch, so the treasury should be the recipient from day one.
- Bags supports launching with a fee claimer wallet through its SDK, which can be the treasury.
- Fee rates and rules on both platforms change over time. Check the live terms before launch.
Transparency
Each epoch publishes the treasury balance, payout, and a merkle root of every PAL's allowance and spend, so anyone can check that fees became compute. Each minted PAL's metadata includes a compute block pointing at its compute account.
NFT spec
A minted PAL is a Metaplex Core asset on Solana mainnet, owned by your wallet and part of the PALS collection. Its traits are checked against your wallet before the server co-signs, so nobody can mint a fake PAL.
| file | content type | holds |
|---|---|---|
| image.gif | image/gif | the animated card: every frame and blink. This is what wallets and marketplaces show. |
| image.svg | image/svg+xml | the same animation as a scalable vector image |
| metadata.json | application/json | name, traits, stats, level and the full animation data |
The asset's URI points to /api/pals/<wallet>/metadata.json on the PALS server, which also serves the images. That's how most Solana NFTs work.
{
"name": "Quillnu · PAL #F35F3C",
"symbol": "PAL",
"image": "…/api/pals/<wallet>/image.gif",
"attributes": [ {"trait_type": "species", "value": "Lantern"}, {"trait_type": "rarity", "value": "Uncommon"},
{"trait_type": "brain", "value": "Claude"}, {"trait_type": "level", "value": 2}, … ],
"pals": {
"p": "pals-v1",
"seed": "sha256:f35f3c…",
"stats": { "FOCUS": 76, "RECALL": 41, "CURIOSITY": 28, "CHAOS": 55, "WIT": 19 },
"level": 2,
"art": [" _|_ ", " [___] ", "|+ +|", "| v |", " [___] "],
"animation": {
"renderer": "ascii-frames-v1", "frame_ms": 360, "motion": "bob", "blink_eyes": "-",
"sequence": [0, 1, 2, 0, 1, 2, 0, 1, 2, "blink"],
"frames": [ [" _|_ ", " [___] ", "…"], ["…"], ["…"] ]
},
"compute": { "fuel": "$PALS creator fees" }
}
}
Animation
The GIF plays anywhere an image does. The SVG plays the same loop with built-in SVG animation, and the animation block stores every frame as data, so any client can rebuild it exactly:
for each step in sequence (loop forever): frame = step == "blink" ? frames[0] with eyes → blink_eyes : frames[step] show frame for (step == "blink" ? 180 : frame_ms) ms apply motion: bob | hop | float | drift | flutter
Memory
Memory is never written to the NFT. It's stored encrypted on the PALS server and belongs to whoever currently holds the NFT.
Cost
You pay the Solana network fee and the rent for the new NFT account. Phantom shows the exact amount before you approve.
Planned
- Inscriptions: write the animated image and metadata on-chain so a PAL renders with no server.
- A memory root hash committed on-chain and updated as the PAL learns.
FAQ
Is this the official Claude Buddy?
No. PALS is an independent project inspired by Claude Buddy. It isn't affiliated with or endorsed by Anthropic, and buddies from Claude Code don't carry over.
What powers my PAL?
Claude. Claude Sonnet does the thinking and tool use, and Claude Haiku writes the memory notes. Compute is paid by $PALS creator fees. See Brain.
Can I reroll my PAL?
No. One wallet, one PAL. A different wallet hatches a different PAL.
Can my PAL trade or move funds?
No. PALs can't sign transactions or touch your wallet. They help you think and plan, and they remember.
What happens if I sell the NFT?
The PAL and its memory go to the new holder. Clear its memory first with /forget all if you don't want to pass anything on.
Who pays for my PAL's compute?
$PALS creator fees, through the compute treasury. Minted PALs get a daily ⚡ allowance with no subscription. See Compute & $PALS.
Is the animation on-chain?
The NFT itself is on Solana. Its animated image and metadata are served by the PALS server at a fixed address, like most NFTs. Moving them fully on-chain with inscriptions is planned.
Is minting live?
Yes, on Solana mainnet. You approve one transaction and pay the network fee and account rent from your wallet.
— end of PALS(1) —